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PERFECTION 


PERFECTION PLUS 


Perfection Is the finest word processor available for any 
computer. We have received dozens of letters from 
happy users saying Just this... and all of these letters 
were unsolicited. "Superb" was used most often. 


Perfection manages to achieve all the sophistication of 
the most complex PC word processors while still using a 
user Interface as friendly as Quill's. Perfection has a dual 
system of user control: menus while you are famillarising 
yourself with the program, and direct commands for the 
time when you feel ready for more adventurous things. 
The two systems can be used interchangeably and even 
simultaneously. Even more exciting — both systems are 
Iterative. In case you don't understand what this means, 
let us give you an example: suppose you wished to move 
a block of text using the menus. You would choose Block 
Move (yes, It is right in the first menu) and the screen 
would then tell you to move your cursor to the start of 
the block. On most word processors you would have to 
navigate manually to this position: indeed, on many of 
them (Quill included) only a subset of the normal 
navigation commands would be available. On Perfection, 
not only can you use all the manual navigation 
commands (viz all 28 permutations of CTRL, ALT, SHIFT 
and the arrow keys!) but in addition you can use direct 
commands like GoTo Line or Page or any of eight 
markers. Even more amazingly, you can use Search 
(either as a direct command or from the menus) even 
though you are already 'within' a menu option. 


Perfection has about 200 commands, but the layout of 
menus and the choice of keys for the direct commands 
makes It very easy to master. Though a 100+ page 
manual is provided (with all the important bits right at 
the front), you should only need to consult it for 
specialised operations like macros. 


Even If speed Is not particularly important to you, we 
assure you that Perfection's lightning performance will 
enable you to use the word processor in sensible ways 
that you would not have dreamed possible before. For 
example, scrolling 100 pages or so is accomplished so 
quickly using the normal navigation commands that you 
do not need to bother using a menu option to do the 
move. Spellchecking, assuming you have Perfection Plus, 
Is accomplished virtually Instantly: to spellcheck this 
whole ad (all the pages) would take under 1.5 seconds... 
Searching (you can switch case sensitivity, as well as 
equivalences between tabs, soft spaces and hard spaces) 
is at the rate of about 100 A4 pages per second. 


Moving from one word processor to another is usually 
very traumatic. With Perfection, this will not be the case. 
Not only can Perfection read in Quill doc and _exp files 
directly (you do not even need to tell it they are Quill 
files!) but it can make direct and immediate use of your 
existing Quill printer driver. File re-export is also possible. 


Perfection Is truly WYSIWYG: this means that bold 
appears bold on screen, Italics appear as Italics, 
underlined as underlined, and so on. Of course, your 
printer may have functions we do not know about 
(upside down?). To deal with these, Perfection provides a 
number of on-screen shaded strips: these can be 
attached to any printer function you wish, and will not 
upset justification as a translate would. Of course, 
translates are provided as well! 


A variety of statistics on the document being processed 
are available: some of them are on view all the time, the 
rest can be toggled to instantly. Not only is there a word 
count, but also page, line, character and special 
character (like Superscript Off) counts. There are also a 
dozen status Indicators, letting you know whether you 
are In Insert or Overwrite mode, whether a block Is 
defined, whether interactive spelichecking Is enabled 
etc. Current line (from top as well as within page) and 
column positions and character codes are also available. 


A terrific feature of Perfection is the dual screen mode. 
You can view one part of the document while editing 
another. The sizes of the two windows are themselves 
adjustable, both in real-time or via the configurator. We 
should devote more space to the configurator: however, 
it must suffice to say that everything that could be 
dynamically set within Perfection may also be preset 
with the configurator. The configurator can, for 
example, allow you to select any of 256 colours for any 
of a dozen parameters (like paper colour, border colour, 
status window ink and paper colour etc). 


Perfection is fully multitasking without need for any 
external accessory: however, If you already use QPAC or 
Taskmaster or similar and are happy, you may go on 
doing so. 


There Is absolutely no way that we can prepare you for 
the quality 'feel' of Perfection. We have a great deal of 
experience using PC word processors costing many 
hundreds of pounds: with absolutely no exception, 
Perfection is far easier to use and master. 


So if you thought Perfection was unattainable, you have 
a very pleasant surprise coming to youl 


LIGHTNING SPECIAL EDITION 
LIGHTNING 


These programs accelerate QL operation by up to 10x (2x 
4x Is typical) without having any adverse effect 
whatsoever on compatibility or anything-else. Lightning 
SE is typically 40% faster than the standard version. This 
acceleration Is totally independent of, and in addition to, 
any speed-up obtained by hardware means. So if you 
have Gold Card, your need for Lightning SE is just the 
same as If you had only an unexpanded QL - Lightning 
SE will accelerate both by the same ratio. 


The Lightning programs achieve their acceleration by 
automatically paging out sections of the QL's operating 
system and replacing these with optimal, concise code 
written by us. 


Lightning installation is a completely automatic and one- 
off: no knowledge of computing or programming is 
required. Once Installed, Lightning can be completely 
forgotten about — you will soon get used to the superb 
speed! Knob twiddlers are catered for too. 


Lightning technology is not built in to any of our other 
programs. Perfection users (as well as users of all other 
QL software) should therefore use Lightning all the time. 


In summary: If you do not have Lightning, you are 
wrong. Buy this one ARST OF ALL! 


PROFESSIONAL PUBLISHER 


The Professional in 
Professional Publisher 
refers to the quality of 


Professional Publisher is 
supplied with a generous 
selection of fonts of vari- 


output from that program, 
and is not meant to sug- 
gest any complexity of op- 
eration. Few programs are 
as easy to use as this 


users will 
be able 
to do 
with- 

out using 
a manual! 
Professional Publisher Is by 
far the best DTP program 
for the QL. It Is fully com- 
patible with Perfection, 
Editor, Quill, Eye-Q & the 
ASCII editors. It allows you 
to both create and import 
both text and graphics. 
Text can be ‘poured’ into 
boxes of any shape, size 
and number, automatically 
maintaining Justification 
and hyphenation settings. 
So flowing text around 
graphics is a doddle. 
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ous sizes, as well as clip 


on” art. 


Justification 

is by pixel, not by 

character. This gives a 
much smoother effect. 
It Is pointless for us to try 
to list all of Professional 
Publisher's features — we 
would end up filling half 
the magazine! We will 
concentrate on just a few 
‘points’: Professional 
Publisher is extremely pre- 
cise, performing all its 
computations accurate to 
a small fraction of a mil- 
limetre. All its features can 
be preset by you using its 
configurator, ruling out 
the need for repetitive key 
strokes. 
The program is extraordi- 
narily versatile while re- 
maining Intuitive In Its 
user interface. Buy it! 


PROFESSIONAL PUBLISHER 
TOOLBOXES 


Toolbox | is an excellent collection of high definition 
fonts, clip art and utility programs for Professional 
Publisher. While the fonts supplied with Professional 
Publisher are excellent, many users will feel the need for 
a wider range of typefaces and styles. 


Toolbox Il starts where Toolbox | leaves off, providing an 
even better — and different - font collection. 


The two Toolboxes complement each other and are 
available together at a special price. 


FONT ENLARGER 
GRAFIX 


Font Enlarger does exactly what you would expect it to 
from its name. While Professional Publisher Is also 
capable of enlarging fonts, it does them ‘on the fly' and 
consequently is not able to remove the Jaggedness 
caused by magnification. Font Enlarger is much cleverer, 
and enhances detail without any step effect. 


While the built-in printer driver for Professional 
Publisher is excellent with 9-pin printers, it is not optimal 
with 24-pin or laser printers. Grafix is. 
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EYE-Q 
ULTRAPRINT 


Eye-Q is the finest graphics program for the QL. While 
there may be other graphics programs with a few more 
features, no other program comes anywhere close to 
Eye-Q in sheer enjoyability. Eye-Q develops a pleasurable 
tactile relationship with you, and makes you feel like an 
artist (even If you aren't). Eye-Q graphics can be read in 
by Professional Publisher, and the latter's pages can be 
exported to Eye-Q (using Toolbox |). Everything in Eye-Q 
is menu-driven and there Is context-sensitive help. 


While Eye-Q has Its own printer driver, Ultraprint allows 
you 22 distinct styles/sizes of printer output. The 
reasoning Is that the scale of gradation suitable for 
pictures is probably unsuitable for text or line drawings. 


PC CONQUEROR 
SOLUTION 


PC Conqueror makes your QL Into a PC-compatible 
machine,automatically. It does this by software means 
only, so there are no screws to undo or wires to fiddle 
with. Your QL stays a QL too. 


Why, might you ask, should you wish to make your QL 
into a PC-compatible? The reason is simple: you may wish 
to run the same programs at home as you do at work. 


Alternatively, you may wish to tap Into the vast 
storehouse of PC software of every type and description 
you could imagine. 


Using PC Conqueror could not be easier. Just boot up your 
machine with the PC Conqueror disk in floppy 1 and 
within 10 seconds your QL will be transformed into a PC 
that is just waiting to be switched on. From this point on 
you will do exactly the same as you would if you were 
running a ‘real’ PC — this means putting a DOS disk (any 
version) Into one of your drives and pressing a key. If you 
do not already have legal access to a copy of DOS, we can 
provide you with one at reasonable cost (see our price 
list). 


PC Conqueror runs as fast as it Is possible for a PC 
emulator to run: we have used all our skills to make it 
work quickly. Of course, you can make the emulation 
must faster by using Gold Card and Lightning SE. With 
this combination, you should get speed noticeably better 
than that of a PC XT... 


PC Conqueror allows you to fine-tune the operating 
environment of the PC in order to improve performance. 
If you get a hard disk or other high capacity floppy 
system, you can utilise part or all of it as a PC hard disk. 


PC Conqueror occupies under 80K and leaves 667K free 
for DOS when run on a Trump Card. This is more than you 
will get on a ‘real’ PC. 


Solution does what Conqueror does but Is about half as 
fast and is not quite as compatible. 


SPELLCHECKER 
MEGA DICTIONARY 


Spelichecker is what makes Perfection into Perfection 
Plus. We have made it available as a separate item for two 
reasons: (a) to allow Perfection owners to add it later 
(b) to allow users of other word processors to benefit 
from the very best in spelichecking technology. 


Spellchecker Is supplied complete with three dictionaries 
of differing sizes as well as a system for building, 
reviewing and maintaining user dictionaries. 


Spelichecker's ultimate accessory Is the Mega Dictionary, 
which gives the user a vocabulary of over 350,000 words! 


3D PRECISION CAD SYSTEM 


This program allows you to manipulate shapes and 
figures In 2D and 3D at a speed that will leave you 
breathless. Irrespective of whether your interest is in CAD, 
in animation or in just having fun, this program should 
not be missed. You can output to plotters directly from It, 
or alternatively create graphics screens to be manipulated 
and output by Eye-Q, Ultraprint or Professional Publisher. 


SUPER SPRITE GENERATOR 


SSG moves things about the screen very fast and very 
smoothly, without flicker. Sprites can have up to 16 frames. 
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contributors who use Archive, Ea 

sel and Abacus, as itis very easy for 
those of us who do a fair amount of writing 
to think only in terms of wordprocessors. | 
use a spreadsheet or database only occa- 
sionally, whereas it is a rare day when | 
don’t use one or more wordprocessors. No 
doubt the statistics show that the majority 
of office and home micros excepting those 
designed solely for games-playing - are 
employed only for text work, like glorified 
typewriters. Nevertheless, integrated soft- 
ware packages always include modules for 
the other functions. 

The trouble with Archive and, to a lesser 
extent, Abacus, is that they are harder for 
the average user to get to grips with than 
Quill is. The same can be said of similar 
programs. You may want only to create a 
name and address list, but are put off by the 
formalities you have to go through to get the 
job done. FlashBack made such jobs much 
easier, but it was effectively abandoned 
before it had been developed fully. Trying 
to explain to someone who has never used 
a computer before why it is necessary to 
have Fields, Records, Variables and so on 
is no easy task. In attempting to do this 
recently, | had to make it clear that what 
was being explained was the conventional 
view of constructing a database, not my 
own way of handling a list of addresses. 


| af is just as well that there are some 


Using Ascii 


Mainly because there seemed no other 
straightforward way of doing it, the transfer 
of my two FlashBack databases from QL to 
PC was done as a simple Ascii text file to a 
wordprocessor. No structure to bother about 
- just a bunch of fields within records, which 
ended up as individual paragraphs in the 
wordprocessor program. That was a year 
or two back, and the files still sitin the same 
wordprocessor program; there has been 
nothing to convince me that they ought to 
be re-created as ‘proper’ databases. 

The only reason this approach can be 
successful is speed. The wordprocessor 
has to work fast enough to allow scanning 
through the databases at a pace which 
does not cause annoyance. My files are not 
large ones (about 60 and 120 KB). At the 
time the transfer was made, my PC was 
effectively much faster than the QL, 
but things have changed drastically 
since then. The Gold Card and Per- 
fection have made the same exercise 
sensible on the QL. Digital Precision 


In a world where 
upgrades are nor- 
mal, we can always 
think of something 
else, says Bryan 
Davies. 


keep records as Perfection files, not 
because they won’t use programs from 
other suppliers but because it is the sim- 
plest and fastest way of handling the data. 
Nevertheless, some of us will still hanker 
for a program with the flexibility of 
wordprocessor but with part of the formal 
structure possessed by database pro- 
grams. What this may mean is a combina- 
tion of FlashBack features with those of 
Perfection or text87. 

Taking a look at software for other com- 
puters, we can see database programs 
which allow data from the same file to be 
presented in several, visually-different 
forms, including those normally associ- 
ated with spreadsheet and business 
graphics programs. One such that | have 
used for some years allows the screen to 
be split into four areas, one showing indi- 
vidual records in a top-to-bottom layout, as 
in Archive, another presenting groups of 
records in a linear, side-to-side fashion, a 
third displaying X and Y axes and several 
graphs plotted from the same data, and 
the fourth giving a boxed display some- 
what like a spreadsheet, with cross-tabu- 
lated data. Thatlastis a bit esoteric, maybe, 
although it can present a quite new per- 
spective on sets of figures. Note that the 
discussion has gone from alpha to nu- 
meric data; there is no real reason why the 
same program cannot handle normal al- 
phanumeric records, such as names and 
addresses, as well as doing calculations 
on the numeric data from the records. You 
can use Abacus for text preparation as 
well as for figure work. 

Having gotall the data, andthe capability 
of manipulating it, why not permit reports 
to be printed out in a really presentable 
manner? ‘Presentation Graphics’ has an 
air of flash about it, but there are advan- 
tages to be gained from printed matter that 
uses some graphics (maybe only a logo). 

We have had some very comprehensive 
and good developments in wordprocessor 
for the QL recently. What | am asking is 
‘can we now have some_ non- 


wordprocessor functions added?’ A little 
bitof FlashBack’s ease of handling records, 
some of Professional Publishers graph- 
ics-import capability, simple formulae as 
in Abacus, the typestyle handling of text87, 
and the general manipulative ability of 
Perfection. All rolled into one. Not much to 
ask, is it? Yes, we do need improved 
graphics to display it all, but the hardware 
stalwarts Up North are already working on 
that... 


What is speed? 


Arecent article and advert may have led 
to some confusion, and amusement, 
among wordprocessor buffs. Is it really 
sensible to make speed comparisons be- 
tween wordprocessor programs? Many 
people would want to see a straight ‘no’ 
answer to that question, but it really isn’t 
that simple, is it? How accurate and valid 
can such comparisons be? Quillis so slow 
performing certain operations that any 
would-be competitor has to be able to 
show that it is very much faster. It wouldn’t 
do to say a Copy operation takes half a day 
instead of a whole one - users want 
something better. With the current stand- 
ards, any normal wordprocessor operation 
that takes minutes is too slow. 

Forinstance, The Editoris quite a speedy 
program - until you use it in Document 
Mode, when it becomes much slower. 
Where possible, any documents used 
during comparison. checking need to be 
typical of what significant numbers of us- 
ers generate, and in the native format of 
the program under test. If quoting times 
taken to load Quill files into other pro- 
grams, remember that this is generally an 
infrequent one-shot operation and, from 
there on, the imported file will be used in 
the format of the new program, so any 
speed checks should be made in that 
format. 

We all have a threshold, below which 
improvements don’t get noticed. My own, 
in connection with program functions, 
seems to be around 25%, but only when 
the time taken is appreciable. A block 
operation that takes 15 seconds instead of 
20 is likely to seem faster to me. Whether 
or not one that takes 7.5 seconds as 
opposed to 10 will be noticed is another 
matter, and the chances of noticing 3 
seconds rather than 4 are not good. At 
levels of less than 10 seconds, itis unlikely 
that most users will be impressed, unless 
an improvementis, say, 50% or more. We 
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are going to be pleased if a 60-second 
operation becomes a 40-second one. 
Something that takes two minutes will not 
be lauded, even if the previous best was 
three minutes, simply because it is still 
stretching our patience. Money permit- 
ting, get a Gold Card first; anything that 
seems slow then will stick out like a sore 
thumb. If you want more speed - and many 
more functions - have a good look at 
Text87 Plus-4 and Perfection Special 
Edition. 

You may think you don’t need anything 
but Quill, but you are quite likely to change 
your mind after seeing a demonstration of 
one of these two wordprocessors. 


Price tumbles 


It may have seemed a bit pointless to 
mention in the April issue that it was (then) 
possible to buy a colour copying machine 
for under £2,000, but that was to empha- 
sise how fast prices come down in the 
computer world. Would you believe you 
can now (less than six months later) get a 
colour copier for under £900 (plus VAT)? 
Don’t get too excited, though. Just look at 
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the prices in the Miracle Systems advert 
and buy a Gold Card and ED drives in- 
stead; they'll be much more use to you. 
Leave the colour machines for another 
year or so (incase you are interested, both 
of the quoted prices are for Brother ma- 
chines). 


Always wanting more! 


The pace of development of Perfection 
Special Edition and Text87 Plus-4 seems 
to have got faster rather than slower. All 
the changes that have been passed to me 
are worthwhile ones, adding significant 
extra functionality or convenience to the 
use of the programs. Watch the adverts for 
details of new features. A full review of the 
latest Plus-4 should appear this month. If, 
like me, you are not satisfied with just one 
wordprocessor, you can now have sev- 
eral, and have more than one document 
loaded into each, and have your favourite 
database on-screen at the same time too. 
Check the illustration - one Perfection 
document at the top, a FlashBack record 
overlaid onto that, and one Text87 Plus-4 
document at the bottom; Ctrl-C then takes 
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you to other documents or programs which 
are loaded. All three programs displayed 
allow you to move and resize their screens. 
The ever-faithful Q_Switch provides the 
indicators at the top of the screen; this is 
one program that looks set to remain on 
my QL ‘for ever’, inthe same form as it was 
configured years ago; it has been great 
value, but is presumably unavailable now. 


And now hardware 


Rumours floating around suggest sev- 
eral hardware wonders may appear be- 
fore the end of 1992. A fast-graphics board, 
lower- andhigher specification Gold Cards, 
a go-faster QL (a replacement rather than 
an add-on board), a QL emulator to fit ina 
PC, an improved hard disk interface, etc. 
As with all such rumours, they should be 
taken with a pinch of salt, but it does seem 
likely that at least one unit fitting one of 
those descriptions will see the light of day 
before long. Itis established that the 68020 
cpu chip can be used in association with 
the existing QL, but we can expect any 
serious new development to be based on 
the 68040 (the 68030 is a starter, but looks 


AOCUUUEOURAUENNCUserseaerenetoerinee 


bi y 


SSSSSESSSSSFSSESFOUSESESSISIESSESUPSSESSSSUSESESISSITSSISIRSIRSSESSE 


ee eeeeeeeeaeoeowN_O_N 


less-and-less suitable as time goes by). 
Still one up 


Having had occasion recently to ask for 
a quotation ona high-end PC, | found with 
surprise that there do not appear to be any 
floppy disk controllers available which can 
support ED (2.88 MB) drives on PCs. Can 
it be that Miracle Systems are the only 
buyers of these drives in the UK? If so, all 
the more credit to them for bringing them 
to us, at a good price. It seems incredible 
that one can get hard disk drives with GB 
(gigabyte) capacity, CD-rom disks with 
500-plus MB capacity, and 50 MHz proc- 
essors, yet have to settle for 1.44 MB 
floppy drives as a maximum on the PC. 


Readers’ letters 


Dilwyn Jones Software have written 
to reply in advance to possible criticism. 
As of early June, the update to the Page 
Designer V 2 Plus - had not been com- 
pleted, and there is no firm date for the 
necessary work to be finished. Money that 
has been sent in is being held, and not 
banked, until copies of the program are 
ready to be shipped. The hope is that this 
will be by mid-July. The reasons given for 
the delay are pressure of other work and 
underestimation of the time needed for 
the program changes. (All the usual!) It is 


SPECIAL OFFER! 


text®7 — 


+ | USER FRIENDLY TO THE EXTREME 


e New well-written manual e Automatic setup and 
installation e Context-sensitive help~e File selector boxes « 
Commands and key-presses highly compatible with Quill. 


+2 THE MOST POWERFUL QL WP 


e Extensive navigation and editing e« Fast block and 
search / replace operations e Reformats as you edit e 
Remembers paragraph formats between sessions e 
Extensive file commands e Spell Checker with browse 
and replace e Multi-Window Multi-Document e Page- 
Preview and Pagination save a lot of time and effort. 


+3 UNRIVALLED PRINT QUALITY 


e Nothing else can compete in text and character 
formatting e Fully supports proportional spacing and 
justifies correctly e Multiple paragraph formats with 
different margins and line-spacing for each e Right, 
centre and decimal tabs e Multiple columns plus headers 


refreshing to have a reply from a sup- 
plier before a complaint is received! 

Digital Precision have asked that 
another warning be published about 
sending blank cheques through the 
mail. While DP is happy that custom- 
ers place such trust in them, they are 
worried about the possible conse- 
quences of a letter containing a blank 
cheque going astray and getting in 
the wrong hands. It is quite possible 
for cheques to be cashed by people 
for whom they were not intended. If 
you must send a blank cheque to 
anybody, mark it ‘A/C PAYEE ONLY’. 
This warning is made for users’ own 
good; it must be stressed that nobody 
has complained to me about any 
cheque being cashed by the wrong 
person. 

Brian Wray wrote to complain that 
Digital Precision had not refunded 
the purchase price of a copy of the 
Payroll program, although they had 
returned his master disk after check- 
ing it. DP replied that Wray’s problem 
with the program had been caused by 
not observing the written instructions, 
and that there was nothing wrong 
with the program disk. The section of 
the program which deals with National 
Insurance contributions had to be up- 
dated by the user whenever the con- 
tribution rate was changed. However, 
they are contacting Mr Wray again 


A SSCL OLIN Leap in QL Wordprocessing 


and footers e Desktop publishing with several different 
page layouts in the same document 


+4 FASTEST QL WORDPROCESSOR 


text87plus4 


If you have paid over £59 for any other QL wordprocessor you can upgrade to text87plus4 
for only £59. The manual from the other software is required as proof of purchase (It will be punched and returned) . 
Offer expires end of August 1992. Send cheque, Eurocheque, to: Software87, 33 Savernake Road, London NW3 2JU 


Amazing timings on QL (much faster with Gold Card) and 
Atari ST with QL emulator. A 70 page text (24,000 words, 
141,000 characters) was used 
Save: 37s (STQL 32s) e Search / replace (with auto- 
reformat) 580 instances: 43s (STQL 14s) e Change 
justification: less than 2s (STQL 1s) e Change right margin 
and reformat 65s (STQL 17s) e Move 10 pages from top 
to bottom With manual marking and positions): 35s (STQL 
15s) ¢ Scroll screen 100 lines: 19s (STQL 5s) 


Fully compatible with all QL ROMs, Gold Card, ST QL, 
Thor. Requires disk drive and 256K memory. 


Prices (inclusive of Air Mail to overseas) 


2488 drivers for 24pin and Bubblejet printers 
typesef90-deskjet drivers for all HP Deskjets 
typeset90-Epson G@5000, EPL4100 /7100 lasers 
fountext88 + founted89 

Graphic driver for 9 & 24-pin printers with over 30 founts 
Ask for our free, comprehensive leaflets. 


TROUBLESHOOTER 


and will supply him with an updated 
version of Payroll; the delay was due 
to a problem over payment for the 
program. Other users who bought 
Payroll from DP (not from PDQL) 
should contact DP for details of the 
upgrade, if they require it. 

PH Tanner wrote again - an even- 
longer letter than before. Long enough 
to fill this issue, in fact! Among many 
other comments, he said that “One of 
my machines runs 24 hours a day, all 
/O taking place via NET”. My own 
machines run 10-15 hours per day, 
but virtually never overnight, mainly 
because everything done on them 
requires my input, whereas Mr Tan- 
ner sets his QLs to calculating and 
lets them get on with it. Note the use 
of the network, and not with the aid of 
Toolkit Il either. It is always hearten- 
ing to hear of someone who has had 
a business lifetime working with bet- 
ter-known, and bigger, computers, but 
prefers to use the QL during retire- 
ment. In this case, the QLs certainly 
work for a living, too. Can anyone 
give an up-to-date report on the GST 
Assembler? |n particular, has further 
de-bugging been done on it? 

No reply has been received to the 
various complaints passed to TK 
Computerware in the past month or 
so. 


e Load: 25s (STQL 17s) « 


£ 79.00 
£ 19.00 
£ 19.00 
£ 39.00 
£ 39.00 
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Media Manager Special Edition (MMSE) Is a program to 
be used both when things have gone wrong as well as 
when things are perfectly OK. It allows for automatic, 
semi-automatic and manual correction of a huge variety 
of disk and tape problems. It allows you to explore disks 
and tapes to your heart's content, producing all sorts of 
different diagnostic reports. MMSE Is very simple to 
operate, being menu-driven and assuming no degree of 
computer knowledge whatsoever. 


MMSE also allows you to tidy, catalogue, sort and order 
your disks and cartridges. 


The standard Media Manager is both less powerful and 
less user-friendly, but manages to work on an 
unexpanded QL. 


Both programs allow for data transfer between PC and 
QL. With MMSE, this transfer is at file and directory level, 
Is bi-directional and Is completely automatic. 


These programs are quite primitive compared to 
Professional Publisher. However, if you have not 
experienced that program as yet, you will find both of 
these very competent. Both are capable of producing 
excellent results. The cheaper one has fewer features but 
Is able to run on smaller systems. 


With the sole exception of Perfection, this is the best 
word handling system on the QL. Editor's features 
Include an unrivalled degree of programmability and the 
ability to cope with the entire 256 character ASCII set. 
The Special Edition has enhanced document-type 
facilities, Including column blocks and on-screen page 
break displays. Neither program is suitable for 
computing novices. Until Perfection, Editor Special 
Edition would have been our ‘Desert Island Program’. 


Editor SE can do a few things that Perfection can't, so 
the ideal combination is to have both (they are 
compatible at file level and can multitask). If you order 
Editor SE at the same time as Perfection, you can have 
Editor SE at half price. 


The Astrologer program teaches you Astrology from 
scratch and enables you to automatically produce text 
narrative on personality delineation, year-to-year and 
minute-to-minute life predictions, compatibility 
interpretations and so on. Whether or not you believe in 
astrology — indeed, especially if you do not — this 
program Is one that you cannot afford to have. You can 
tallor the readouts (both In terms of quantity and what 
is said) to your own particular requirements. The amount 
of fun you can have with this program Is endless. Do not 
blame us if you start believing in astrology, though! 


Astronomer Is an extremely fast and accurate solar 
system calculator, with planetarium views, planet faces, 
eclipses, cinerama display etc.. 


Turbo is the finest BASIC compiler for the QL and 
arguably the finest BASIC compiler for any computer! 


Turbo automatically converts working BASIC programs 
into optimised machine code, usually with no need for 
human intervention. The benefits of this conversion are 
vastly enhanced running speed (as well as much faster 
loading, encryption and automatic bug fixing for a variety 
of QL interpreter oddities). Typical speed-up Is 40x - 100x. 


Turbo Is provided with a 200 command toolkit, adding 
many useful commands to BASIC. Most of these 
commands will be of immediate use to the programmer, 
whether he is a novice or an expert. There are commands 
to load strings and floats into RAM, and to extract them 
automatically; to search memory and to move Its contents; 
to control jobs and change their priorities, manage pipes, 
allocate and deallocate memory, to control both rubber 
and virtual arrays, to present INPUT with an editable 
default, to have random access to files and much more. 


Toolkit Ill starts where Toolkit ll stopped, adding about 
60 new commands and enhancing many existing dual 
functions. Toolkit Ill Is available either on disk or on 
ROM, and works whether or not you have Toolkit Il. 


Toolkit Ill commands can, with only a couple of 
exceptions, be compiled using Turbo. 


All QL owners have a copy of Archive, supplied free with 
the QL. While Archive Is competent, It Is very hard to get 
to grips with and is not particularly fast. QFlick presents 
a very convenient alternative - a snappy , simple-to-use, 
pointer-controlled card file database. You can move data 
between QFlick and Archive in either direction. 


QFlick Is not Itself programmable but we document its 
data structure and give guidance on how to program It 
using Turbo. 


This suite of utilities will greatly enhance your use of the 
Archive database system. 


Archdev + RTM Is a straight replacement for Archive: It 
gives enhanced speed, greater workspace and a much 
cleaner boot-up. All your existing applications will work. 


Database Analyser provides very fast and comprehensive 
statistics about your Archive databases. 


Archive Tutorial proceeds systematically through the 
whole philosophy and grammar of Archive, providing 
you with expert and patient guidance. 


Names + addresses, Mailmerge and Dat-Appoint are 
ready-to-run, off-the-shelf Archive applications, 
providing an address database, mallmerging and 
appointment diary respectively. You now have no excuse 
not to use Archive. 


SEdit allows you to create and edit screen format files In 
Archive. Screenprint allows you to print them out. 


Recover allows you to get back lost Archive databases, 
created when you switched off the computer without 
properly exiting from Archive. 


XRef analyses the structure of a BASIC program, 
providing detailed reports on things like variable usage, 
what calls what, dynamic call hierarchy of procedures 
and functions, and so on. 


SuperBasic monitor actually monitors and reports on the 
performance of BASIC programs as they run under the 
interpreter. 


BetterBasic analyses and automatically corrects structural 
flaws in your programs and allows you to customise 
things like indentation, number of statements per line, 
filtering out of noise words, etc. 


The three programs together provide a matchless 
diagnostic and auto-correcting facility for BASIC 
programs. 


This program copies files at high speed between devices, 
performing translates as it goes along. Ideal for all sorts of 
applications, including transfers from microdrive to disk. 


This is an Incredible mathematical compendium for the 
QL. Pride of place goes to the symbolic problem solver: 
this can solve equations, simplify expressions, factorise, 
expand, etc, all symbolically. If you could sneak this one 
Into a maths examination, you would have a formidable 
ally. QMaths knows about all the algebraic operators, 
powers, roots, brackets, trigonometry, matrices, 
determinants, vectors, factorials, permutations, 
combinations, binomials, exponentials, logarithms, 
hyperbolics, Inverse functions, infinite series Including 
Taylor & Maclaurin expansions, complex numbers, 
conversions, Fourier series, and lots of calculus: both 
differential and Integral, induding Integration by parts 
and definite integrals. QMaths optionally displays Its 
workings and comes with a superb interactive tutorial. 


The package also contains an interpretive, fractal, Image- 
generating language with loads of beautiful fractal 
programs supplied for you to use and edit - no 
programming skill is required. 


There Is also a multiple precision floating point maths 
package, giving calculations at precisions up to over 600 
decimal digits of accuracy. 


There Is even more to this system, but we think we have 
told you enough. 


The latest version of Tony Tebby's superb monitor: an 
absolute must for those who really want to know what 
Is going on In the QL. No other machine code monitor 
even comes close. 


Do not confuse this program with SuperBasic monitor, 
which monitors SuperBasic, not machine code. 


This program compares files - data or program - at 
colossal speed. Where a mismatch Is detected, the 
relevant areas are highlighted and you can shuffle, 
displace and align very easily. 


Cash trader with Analyser is an accounts system designed 
by businessmen and not by wretched accountants! 
Consequently, it has excellent reporting and 
management facilities, and is very flexible. It Is almed 
primarily at the layman, probably a sole trader running a 
small or medium sized business. All the features you 
would expect - Including audit trail - are present. 


Payroll Is a reasonably flexible system designed to 
automate the payroll function in small businesses. 


Both programs are configurable, with editable defaults 
letting you adapt the programs from year to year. 


This is the ultimate hard disk backup and management 
utility, with all the sophisticated features you could 
want. User dialogue is via overlapping pop-up windows - 
the whole program Just feels right. It Is possible to scan 
the disk at great speed, too. 


This permits you to add password protection to disks, to 
optionally increase disk storage capacity on DSDD drives 
by 36K and to increase speed of access by as much as 
30%. All this is done while maintaining full compatibility. 
Automatic file management Is also provided. 


These are extremely fast and efficient C compilers, 
complying with and surpassing the Small C definition. 
The Special Edition goes much further, including support 
for structures, pointers, long pointers, >64K code size, 
direct access to QDOS traps, etc. The Special Edition C 
generates code that runs about twice as fast as the other. 


THE INFORMATION PAGE 


PERFECTION SPECIAL EDITION WORD PROCESSOR 

The most versatile, friendly and powerful word-processor of all — PC users, eat your 

hearts out! Another year's work on PERFECTION has produced PERFECTION SPECIAL EDITION, 

wih all re features of the previous version plus much much more (yes, we have been 
istening): 

* Improved user-friendliness and even better feel. 

* Stores and recalls upto six "environment" settings (each setting including all tab, 

rE pete peeeretin a ee etc positions for very easy document manipulation) at the touch of 

a key. This transforms the use of the program! 

* Now eight strips (previously 4) to support greater variety of printer functions such 

as changes of fonts and sizes. 

* Now allows 64 other translates (of up to 63 characters each), for those with 
sophisticated printing needs - an improvement of sixteen times. Also a new print 
terminate option, allowing a reset of printer controls and gp ee of the print buffer. 

ec ae printer driver now supports all PERFECTION string editing commands (F5, up, 
own too). 

* Totally compatible with all document files (own, standard PERFECTION, Quill doc, 

Editor and SE, ASCII, Archive/Abacus/Quill/text87 export, non-ASCII, machine Code, 
compressed data etc) and with printer data files (own, standard PERFECTION, Quill 

printer dat) — no re-entering! 

Sai accelerated reformatting speed - typically five times faster than standard 
PERFECTION. No longer any need to wait around if you wished to change (say) margin 
and/or jos tii ication settings of all or most of your document. 

reatly accelerated global search and replace - typically four times faster than 
standard PERFECTION. 
* Numerous other speed enhancements too. 
* Improved and enlarged Configurator, Dictionary Utility and Stripsort. : 
* Greatly improved piping of output to the Professional Publisher system, giving 
thousands of fonts, full pixel-proportional spacing with auto-everything, even down to 
the choosing of the allocation of % of space added "between characters" and "between 
words" to an accuracy of four thousandths of an inch, you can auto-— prevent ugl 
oo Seat er (too few letters in front or behind) and word-wrap arords too spread out) 
effects, superb output quality and undreamed of flexibility. 2D pee else on the Q 
gives you anything like this level of flexibility and quality of print output (many 
superlativeof fonts, hundreds of sizes, wrap-around (contour) graphics and pictures. 
* Improved cursor navigation. 
* Merging now works for both PERFECTION saved and exported files as well as for ASCII 
non-P ION files. 
* Much more besides... 
* PERFECTION SPECIAL EDITION costs £99.95, or £139.95 with Spellchecker and three 
dictionaries (i.e. PERFECTION PLUS SPECIAL EDITION). The price of standard PERFECTION 
has been reduced to £59.95, or £99.95 with Spellchecker and three dictionaries. 
* Existing PERFECTION users can upgrade to PERFECTION SPECIAL for the difference in 
current price plus £10 (so £50 to upgrade from either PERFECTION to PERFECTION SPECIAL 
EDITION, OR PERFECTION PLUS to PER ION PLUS SPECIAL EDITION - return all disks but no 
manuals). Please upgrade now as the upgrade price is liable to be increased soon. 


LIGHTNING SPEC(AL EDITION GOLD CARD VERSION 

For Gold card users only, we are sup lying a version of LIGHTNING SPECIAL EDITION 
identical to the current version of the other one but without the ROM (which is 
redundant if you have Gold Card) at the reduced price of just £39.95, or as a £25 
per from standard LIGHTNING (return everything). Gold Card owners who have the 
LIGHTNING SPECIAL EDITION with ROM can send DP their ROM cartridge for a £5 credit 
towards future orders. Alternatively, you can upgrade from the "full" SPECIAL EDITION to 
the Gold Card version for free (return your disk and ROM, not the manual) as you will 
benefit from the updating, accelerating and refining that has gone into LIGHTNING 
SPECIAL EDITION since you purchased your's (our latest update was on 15th May 1992). 


DESKSET/LASERSET DRIVER FOR PROFESS(ONAL PUBLISHER | , 

If you have one of these Hewlett Packard printers, this addition to the Professional 
Publisher range is an absolute must at £19.95 — output quality is superb. 

COPY OT(LITY FOR BACKING OP 

TRANSFER OTILITY SPEC{AL EDITION ; ‘ ; 

COPY gives you a full-function interactive backup (no more fiddling around with WCOPY!) 
with plenty of options. TRANSFER UTILITY SPECIAL EDITION can back-up, transfer, make 
translates and now even sorts (on a variety of options, including filename, creation 
date and size) before creating an optimised (for speed of access) copy - and all this at 
lightning speed, faster than WCOPY or similar! MANY NEW PRODUCTS ANNOUNCED HERE 
CHRAP MICROCARTRIDGES AND ON THE STOP PRESS PAGE! ! 

£50 for 50, £80 for 100, all inclusive. Why pay more? 


STOP PRESS/PRODUCT INFO 


PC CONQUE&OR GOLD SPEC(AL EDITION — ; , , 

A fantastic all-new Sonor See tee making your QL into a PC and gece to run PC 
software. PC CONQUEROR GOLD SPECIAL EDITION will operate only with GOLD (or other 
an hardware giving 1.5 Mb RAM or more). It has (of course) all the features of standard 

CONQUEROR, and in addition: 

* Full and automatic support for expanded memory (complying with all the relevant PC 
standards). On a Gold Card, for example, the user will get 736K base memory (vs only 
640K on "real" PCs, and 667K on standard PC CONQUEROR) US expanded wae variable 
between OK and 944K (could be higher if you have even more RAM on your QL). The presence 
of expanded memory improves the performance of most PC software, and is essential for 
the operation of some of the more modern and/or advanced PC programs. Further, no 
separate "driver" needs to be installed from the DOS, savi even more RAM over 
conventional PCs and operating systems (where a difference of as little as 4K is 
considered worth mentioning as a substantial E caches . Part or all of the expanded 


memory can be allocated to ramdisk(s) and/or disk cache(s). 
* Full support for high density (HD) disks (though the CONQUEROR GOLD SPECIAL EDITION 
works per een well on single or double density drives too, if that is what you paved « 
iving you 2880 sectors per disk. You can now read, write and format PC HD disks 
(provided of course that you have HD or ED drives on your QL), and the disks you use 
will be completely interchangeable with (in both directions) and indistinguishable from 
DD and HD disks produced on a "real" PC! Disk access speed for HD is better than twice 
the speed of double density (which was all that standard PC CONQUEROR could handle). Of 
course you can still read, write and format PC DD disks too, if you wish. ; 
* You can now easily create a PC "hard disk" on any QL device (including floppy disk) 
and boot up from it if you wish. From within the PC, that. drive will look and behave 
just like a hard disk (and a very fast one too if you use RAM as the QL device). From 
gn0s the hard disk will look like a normal QL file, so backing-up is a dream! 
cifically, if you have (or are going to acquire) ED drives (from Miracle Systems or 
elsewhere) , au will now be able to create any number of pseudo-hard disks (with over 
3,200,000 bytes per individual disk), and automatically boot from them if you wish. Disk 
access speed is_ typically five times faster than with DD drives. This is an excellent 
way to use PC CONQ RR GOLD SPECIAL EDITION. 
* Automatic sensing and switching between disk types (360K/720K/1.44Mb) at DOS level, 
with manual override! 
* Upto just over 50% faster operation than standard PC CONQUEROR on most Gold Cards (PC 
CONQUEROR GOLD SPECIAL EDITION automatically determines whether your Gold Card can run 
the software at accelerated speed. Even if it cannot, you will still get faster 
operation than with the standard PC CONQUEROR. 
* You can design, if you wish, your own colour map so that all screen colours are 
pone gured to your. liking - tailor PC programs so that they look the way you want them 
to (of course, no PC can do this). 
* Many other op eisai eee and features, enlarged SoC ante and supervisor mode. 
* Fully compatible with all versions of MS-DOS, DR- and PC-DOS from v1.0 to v6.0 
cera inclusive. 
* PC CONQUEROR GOLD SPECIAL EDITION package includes a copy of the standard PC CONQUEROR 
too, in case en have other QL setups with less than 1.5 RAM. 
* PC CONQUEROR GOLD SPECIAL EDITION costs £99.95 including VAT and delivery. Standard PC 
CONQUEROR has been reduced to just £59.95 inclusive — excellent value — and SOLUTION PC 
Emulator to just £29.95 inclusive. Existing Digital Precision emulator owners can 
upgrade for just the difference in current advertised betes gius £10 (so the upgrade 
from PC CON R to PC CONQUEROR GOLD SPECIAL EDITION is just £50, for example - return 
only the disk and not the manual. The upgrade from SOLUTION is £80: send back 
everything). Please upgrade now as the upgrade price is liable to be increased soon. 


DR-DOS v6.0 
DOS. v5.0 has now been superseded by DR-DOS v6.0 with many new features, probably the 
most useful of which is disk compression "on the fly" (i.e. data is automaticall 
compressed before it is written to the disk and automatically decompressed as soon as i 
is read off the disk - so everything works as before). Compressions range from 2x - 8x 
depending on the type of file: imagine how huge your storage devices will become! There 
many other enhancements over v5.0, including an on-line DOS tutorial, built in disk 
cache, many diagnostic and backup utilities and much more. DR-DOS v6.0 will work with 
all our PC emulators. The price including all documentation (two large manuals), ready 
reference guide and our pre-configured QL/DR-DOS v6.0 disk (ready to run) is £80, or a 
concessional £70 if ‘de have purchased an earlier DOS from us (this is not an upgrade — 
pe keep the old DOS too). If bought at the same time as PC CONQUEROR GOLD SPECIAL 
DITION, the combined price is £179.95, or £139.95 with the standard CONQUEROR, or 
£109.95 with SOLUTION. 


THS MATHEMATICAL SYSTEM PART TWO an : 

follow-up program to complement QMATHS, giving excellent and optimally speeded 
Mandelbrot and Julia set visuals, enhanced statistical functions, terrain plotting, 
function evaluation and much more. The price is £59.95, or just £99.95 for the pair 
(QMATHS Parts 1 and 2) - a saving of almost £30! 


3-D PRECISION CAD SYSTEM : 
ADVENTURE CREATION TOOL SPECIAL EDITION 49.95 
ARCADIA GAME 9.95 
ARCHIVE DEVELOPMENT SYS + RUN-TIME MODULE 29.95 


SPECIAL DEALS 


5% off total if you buy 2 programs/upgrades; 
10% off 3; 15% off 4; 20% off 5; 25% off 6+ 
Upgrades cost difference in price + £10 


9.795 

Non-UK Europe add 5%, rest of world 10% 99.95 
For full terms and conditions, please refer to any of our QL World ads from Jan-Nov 1990, or write In Including a SAE 19.95 
9.95 

a 

CPORT BASIC TO C CONVERTER 19-95 


This program translates SuperBasic programs directly into C source code, automatically. 
This C source code may then be edited or compiled. If you want to move programs to C 


for migration to other hardware, or want to accelerate your programs, or just want to 24.95 
learn C the easy way (chuck BASIC in one end and examine the C that spews out of the 29.95 
other), CPort Is the system for you. 49.95 

19.95 
CPort Is friendly and tolerant of poorly written BASIC. There is even a method of dealing 9.95 


with unusual BASIC keywords. The generated C, which can be switched between the 
ANSI and Lattice industry standards, Is very readable and Is often optimal. CPort's user 
Interface is extremely friendly. CPort Is available with or without the C68 compiler. 


DR-DOS v6.0 STATE OF THE ART PC OPERATING SYSTEM 79.95 
EDITOR SPECIAL EDITION 49.95 
EDITOR 29.95 


EYE-Q GRAPHICS SYSTEM 39395 

FONT ENLARGER 19.95 

SUPERFORTH COMPILER WITH REVERSI GRAFIX 24 PIN- UNIVERSAL, PRINTER beIvEr 14.98 
HARDBACK + FINDER HARD DISK MANAGER 49.95 

Forth is the most logical computer language. This compiler produces multitasking code. 24.95 
The manual teaches you Forth-83 from scratch. y -95 
-95 

49.95 

13:38 

IDIS SPECIAL EDITION 49.95 

24.95 

IDIS 29.95 

These Intelligent disassemblers make the otherwise terrifyingly complex task of 39.95 


NAMES AND ADDRESSES DATABASE SYSTEM 19.95 
PAYROLL SYSTEM 49.95 
PC UEROR GOLD SPECIAL EDITION WITH DR-DOS v6.0 pees 


understanding other people's machine code programs absurdly easy. The SE version, 
which has a higher hardware requirement, sorts out some routines, replaces addresses 
with names, untangles data from code and much more. 


QKICK FRONT END SYSTEM 


This is a simple, easy-to-master, pull-down menu controlled multitasking front end. QKick 
runs In the background and can be called up at any time. It provides you with notepads, 
sophisticated file/sector/RAM handling, backing up facilities, a clock, diary, calculator, 
mini-database and so on. 


ADVENTURE CREATION TOOL SPECIAL EDITION 


ACT is a must for every programmer. The name of the program Is misleading, Insofar as It 
has capabilities far beyond the 'mere' creation of adventures. ACT has utilities providing 
animated graphics, data compression, language design, parsing, maps, object-oriented 
control etc. If all you want to do Is generate adventures, though, you do not need to be 
a programmer to use It. This is a purchase you will never regret. 


PEDIT 


PC R GOLD SPECIAL EDITION 9°95 
PC CON R WITH DR-DOS v6.0 139.98 
PC IR 59.95 
PEDIT PRINTER DRIVER FOR XCHANGE 19.95 


PERFECTION PLUS SPECIAL EDITION WITH SPELLCHECKER 139.95 

PERFECTION PLUS WITH SPELLCHECKER ; 99.95 

PERFECTION ae EDITION WORD PROCESSOR 99.95 
WORD PROCESSOR 


TOOLS 

PROFESSIONAL ASTROLOGER WITH ASTRONOMER 69.95 
PROFESSIONAL ASTROLOGER 59.95 
PROFESSIONAL ASTRONOMER 29.95 
PROFESSIONAL PUBLISHER TOOLBOXES (PARTS ONE & TWO) 49.95 
Tee EAL) EVEL Tote TOOLBOX PART ONE 29.99 
PROFESSION. HER TOOLBOX PART TWO IIS: 
PROFESS TONAL PUBLISHER 89.95 
FLICK CARD INDEX SYSTEM 29.95 
ICK FRONT END SYSTEM 24.95 
THS MATHEMATICAL SYSTEM PART ONE 69.95 
‘THS MATHEMATICAL SYSTEM PART TWO 59.95 
THS MATHEMATICAL SYSTEM mee ONE & TWO) 99.95 
MACHINE ve or a Vv 39.95 

VER ARCHIVE 19595 
REVERSI GAME 9.95 
SEDIT + SCREENPRINT ARCHIVE UTILITIES 39.95 
SOLUTION PC EMULATOR WITH DR-DOS v6.0 109.95 
SOLUTION PC EMULATOR 29.95 


A fast, modern and capable printer driver for the programs bundled with the QL. SPELLCHECKER WITH DiS TiONAnts 49.95 
EMULATO! 49.95 
24.95 
39.95 
MICROBRIDGE 73.98 
SUPER S' 29.95 

Superb contract bridge bidder (ACOL etc) and player, using millions of random but 4 
reconstructable hands. Microbridge also includes a state of he art Interactive bidding TOIT 1H 11 mith Rou a ge 
tutor and a clear Instruction manual. There is nothing like this anywhere else! ee ory SPECIAL EDITION 29.95 
TRANSFER UTILITY 9295 


TURBO BASIC COMPILER + TOOLKIT 79.95 


ULTRAPRINT SCREEN DUMP UTILITY 19.95 
SUPER ASTROLOGER XREF SUPERBASIC PROGRAM ANALYSER ; 29.95 
KEY>>)>>)> Available either on cartridge or disk 


A very cut-down version of Professional Astrologer — still great fun, though! Available only on disk 


Minimum 512K exp:only available on disk 
SUCCESS CP/M EMULATOR 


Minimum 256K exp:either cartridge or disk 
Minimum 256K exp:only available on disk 
Allows your QL to run CP/M programs at great speed. 


Available only_on cartridge 
Minimum 1.5Mb RAM:only available on disk 
As Yell as Gamer idee or disk, you get a ROM 


SH HTAGO STH OOS SSM STH HOH STAD DDAHOHDNOANORPHAO TOOTH SPANDHOSPMDOMMOAAMRRPARDHPTHAMHOHMOSHPADHSTHPHANDNAMNABHPOAODARHOA 


Send to: DIGITAL PRECISION LTD, 222 THE AVENUE, CHINGFORD, LONDON E4 9SE or phone 081-527 5493 
Please rush me: 
Name: 


40 
es ie AMODIGITAL PRECISION cro attcnm Precesoni 
= O Oo 0 


Card NO uk 26 Expiry: Signed: 


Delete as appropriate: (QUTHOR/STQL)(MDV/3.5"/5.25")(Disk=360/720/1440/2880/6400 sectors; nb 1 sector=0.5K)(If 720 sectors: SSDD/DSSD) 


SCENE! 


Fax rolls for printers 


Reader P J Hudson has followed up his comments in Bryan Davies’ column (page 4 of the April 1992 QL 
World) on the use of fax paper with the Serial 8056 printer, by contacting supplier Office World (full name 
Globus Office World Plc) of Reading. Their Summer (May to August) catalogue (“We guarantee that our 
prices are absolutely rock bottom!’) lists various sizes of fax roll paper, used by some QL World readers as 
aconvenient source of printer-paper for reel-fed machines. The relevant price list can be found on page 107 


of the catalogue under Fax Rolls. 


Mr Hudson points out that the 30m rolls have the correctly-sized core for use with the Serial 8056, and his 
custom of re-winding the 100m rolls is simply to take advantage of economies of scale. Office World deliver. 
Office World has stores in Leicester (0533 516222), London (081 961 8244), Northampton (0604 
34456), Nottingham (0602 599499), Reading (0734 568865), and Slough (0753 551234). Enquire there 
for up-to-date prices and catalogues. 


Clarifica- 
tion hy 


Software 
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At the time of placing their 
advertisement in the June 
1992 issue of Sinclair QL 
World, Software87 (the 
producer of text87) was 
unaware of the existence 
of the Digital Precision 
program Perfection Spe- 
cial Edition. The bench- 
marks quoted by Soft- 
ware87 in that advertise- 
ment hence definitely did 
not refer to the Special 
Edition of Perfection, 
which is understood to be 
much faster than the 
standard version of Per- 
fection. In addition, Soft- 
ware87 would like to point 
out that the benchmark for 
Search and Replace quoted 
by Software87 in the same 
advertisement may have 
been unfair to the program 
actually referred to. Soft- 
ware apologises to Digital 
Precision for any incon- 
venience caused. 
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Speccy Emulators in Italy 


Ergon Development is bringing to light two Spectrum emulators for 
the QL. The ZM-2 and ZM-3 ZX Spectrum 48K emulators emulate all 
standard Spectrum features (keyboard, tape reading and saving on Qdos 
devices) except sound. The two versions give a choice of facilities: the 
ZM-2 runs more slowly than the ZM-3, but has a higher compatibility 
rating. For instance, on a 16 MHz Gold Card games run on the ZM-2 
from 35% to 70% of normal Spectrum speeds, while on the ZM-3 they 
run from 50% to 90% of normal speed. Speed, of course, depends on 
various factors, such as screen redrawing, screen mode, instruction type 
executed, and so on). 

As for compatibility, some of the games quoted as running ‘excep- 
tionally well’ on both emulators are Jetpac, Pssst, Sabre Wulf, The 
Hobbit (kill Thorin), Atic Atac, Manic Miner, UnderWorld and Knight 
Lore. The emulators are controlled by the ‘Supervisor’, which allows 
users to manage Spectrum files on QL devices, to disassemble/dump or 
poke the Spectrum memory, to redirect Spectrum keys to QL cursor 
keys, and more. 

The complete ZM-X (ZM2 and 3) system costs £35 and is supplied 
with QL programs (on disk) and Spectrum programs (on tape) for 
transfer to the QL through the network or the serial port, for example, 
with the Interface 1). Ergon have also developed a full working public 
domain version, the ZM-1. 

Prices quoted do not include carriage (£5 airmail postage), Please 
send cheques or (preferably) Eurocheques in Italian lire (£1 - 2200 lire), 
OR add £4 to cover conversion fees if sending any currency cheque 
other than lire. 

Ergon also offer discounts on total orders: £3 off for two programs, £6 
off the three programs, and so on. Please make payments to Davide 
Santachiara. 

Orders and enquiries to Ergon Developments, Via Emilio de Marchi 
n “, 42100 Reggio Emilia, Italia. Tel (Italy) (+39) 0522 70409. 

Ergon have also just released Open World 2.1, to allow QL users to 
convert graphic screens created with other computers into standard QL 
screens. It can import IFF (Amiga), CUT, TIF (PC and Mac) and GIF 
files (mainly from bulletin boards). Images can be converted into four 
colours, eight colours, or monochrome (with a very powerful dithering 
algorithm) screens. The monochromes are ready to be loaded into QL 
desktop publishing programs. Open World (OWR) costs £25 and comes 
with a supervisor program, and two 720 K disks full of GIF, IFF and TIF 
images. 


Merz 
releases 
OSpread 


Merz Software’s QSpread 
spreadsheet for the QL, run- 
ning under the QJump Pointer 
Environment, is now ready for 
market. The early news from 
Jochen is that the program is 
fully pointer- and keyboard- 
driven, can split windows three 
times vertically and horizontally, 
giving a total of nine working 
windows; is formula-oriented, 
so that formulas can always be 
retrieved, even after numerical 
input has taken place (unlike 
Abacus); allows function mac- 
ros; allows atotal of 32,767 cells, 
laid out in whatever horizontal 
and vertical configuration the 
user chooses. Block handling and 
number value entry has been 
made ‘a lot easier’ than in Aba- 
cus. 

As usual, all necessary pointer 
environment and menus material 
is included in the package. 
Qspread will cost £49 from 
Jochen Merz Software, im 
stillen Winkel 12, D-4100 
Duisberg 11, Germany. Tel. 
101 49 203 501 274. 

Further news from Merz: the 
SerMouse driver is now in ver- 
sion 2.00, with smoother mouse 
movement and other improve- 
ments. The QL Emulator for the 
Mega STEis in prototype, and is 
expected to be ready by August. 
More news when that arrives. 
QDesign 2, the upgrade to 
QDesign, improves on the origi- 
nal Qdesign in anumber of ways, 
but the incompatibility with early 
QL rom versions (according to 
our report, this includes early 
Minervas) remains. 
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AIM D .. 


im stillen Winkel 12 - D-4100. Duisburg 11 
Germany - Telephone & Fax 0203 501274 


QD 4- Editor using the Pointer Environment, with many new options: GOTO 
BASIC Procedure/Function, Label, improved parameter string, print, search/ 
replace, and MenuConfig (the same as Config, Patimenu-dtivelt £38 Upgrade 
from V3 £10 
QSpread - Spreadsheet for the pointer Env. More than 32000 [N[E\VVY 
cells. Completely pointer-driven, up to 3 horizontal and vertical 
splits at the same time. Formulate-orientated, 22 scientific funct- NEW 
ions, macro functions, help;'scrap, etc. £49 
QMenu - Menu Extension V3 QMenu is a very easy to use interface with 
predefined menus (e.g. file select, simple choice boxes, select from lists). These 
menus may be used by super BASIC, machine code and other languages. File- 
select, dir-select and list-select all re-written with more options, multi-columns 
etc. £12.90 Update from previous version with new manual £5 
FiFi-the FileFinder. FiFi is easy to use and extremely useful: it scans devices 
or directory trees and searches files or filenames for strings. Combinations are 
possible, e.g. String 1 AND string 2 BUT NOT string 3 etc. £13 
DISA - Intelligent Disassembler. Generates ASCll-output which may be 
assembled using the GST (Macro) Assembler. £27 
QDOS Reference Manual - This book is a must for all machine-code 
programmers. It explains how to use QDOS, all traps and vectors, the Thing 
System, the HOTKEY Syst.11 and much more. It shows which features work on 
a QL, an Emulator, how to write compatible for future operating systems. 170 
pages. £27 
QPTR - The Pointer Environment Toolkit. Revised manual which de- 
"scribes how to use the Pointer Interface and the Window Manager for Super 
BASIC and machine code. Examples on disc, keys, macros and extensions for 
SuperBASIC. £27 
FLP/RAM Level 2 now with ATRI!! Replacement EPROM for Qboards 
(V1.17 onwards, with & without mouse) or TrumpCard (please specify!). 
Real sub-directories! About twice as fast, with improved slave-block-handling! 
(not on JM-ROMs) £18 
EASYPTR I | - Create yourown Pointer-Env. menus & sprites, use them in your 
SuperBASIC or machine-code programs. Supports all the PE facilities, even 
split application sub-windows and uses the Menu Extension! Many examples ! 
£49 
SYSTEM - System Tools for QDOS: real file - attributes are added, e.g. 
write-only, hidden or for selected users only. Works even over net and on 
winchester. New TRAP#3. New devices (equiv. to QL-Emu.): named pipes, 
MEM, NUL. 80 new procs & features, e.g. WSET_FATTR, 
WSET_FTYPE,WSET,FVERS, ADIR, ASTAT £27.50 
QDESIGN II - more features, improved and more printer drivers (incl.) laser, 
QSnap which scans text from screen and puts it into scrap, virtual drawing mode 
on Emulator and Minerva etc. £48. Upgrade from version 1 £13 
VECEDIT Vector-Font-Editor for QDesign £19 
NEW: SER MOUSE V2 - Software rier which allows you to connect a 
serial (e.g.) IBM-style) mouse to one of the SER ports of the QL, which then 
mimics the QIMI interface. On a 3-button mouse, you have ESC, Wake and 
Sleep in addition. £14 
The Lonely Joker - three patience card games, very addictive and playable 
with many options. With PE etc. Needs Toolkit | | £14.90 
Diamonds £11 - BrainSmasher £12 - Arcanoid £10 - Firebirds £10 
- SuperGamesPack £25 - QShang £14 - QSUP System Utility Pack 
£26 - Thing & Eprom Manager £18.50 
New QL-Emulator - the VME card for the Mega STE should be ready 
when you read this ad. Please call or write for more info. 
Floppy adaptor to connect QL diskdrives to the ST £9 
VERY SPECIAL OFFER; Harddisk unit for the ATARI ST (without 
harddisk): case for Syquest changeable drive AND 5.25" or 3.5" drive, PSU, 
host-adaptor (100% QDOS compatible), cables, driver, thermo-controlled 
ventilator etc. £120 
QDOS on a 68030 (in every Mega ST) running at 32MHz: incredible speed 
(approx. 8 times faster than a ST, 20 times a CLF together with new E-Driver- 
Software. Write for more details! Price: 32MHz Version £600, 25MHz 
£500 
NEW: E-Driver software with new initialisition: faster, needs less 
memory, boots from harddisk without EPROM etc. With new manual £17 
Technical Printer Manuals: ; 
EPSON ESC-P/2 for all EPSON 9/24/48 pin printers. 500 pages £27 
HP DESKJET for the Deskjet family (including 500C) £15 


We are the German distributor for Software 87 products (German & English 
versions available!). 


Please add £4.50 for p & p (Europe) or £4.50 for one item and £2.50 for 
every further item (Overseas). All prices excl. V.A.T. E&OE. 


EIEN 
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Falkenberg Hard Disk Drives 


Hard Disk Kit Complete Set, boxed with PSU 
£365 


32MB Hard Disk £300 
20MB Hard Disk £258 


£322 


The Hard Disk Kit comes without Box and PSU. If used with a gold card and bus expander the 
access time is greatly improved. (On a QL with Gold Card, approx 350,000 Kilobytes/second) 


The QL Hard Disk Interface and Hard Disk controller boards can be mounted in various configurations 
as required. The following items are normally carried in stock and can be selected as required. 


BUS Expander, 2 slots, (eg, for disk interf: 


‘old card and hard disk controller} 


Horizontal/ Vertical Connector £22.00 Flexible cable Connector £ 30.00 


Inter- Into QL (eg, Gold Card) 
faces 


is Into QL 


rs (eg. HD 
(mes es =F 5, 
i} Into QL 


BUFFERED BUS Expander, 5 slots, (For expansion other than Trump/Gold Card) 
Horizontal/ Vertical Connector £59.00 Flexible cable Connector £ 69.00 


LI tel J 
U4 Into QL 


FILS” 


BUS Redirector, 1 slot, helps to reduce the width of extended QLs £ 17.00 


RAM/ROM Battery Backed Memory Card (Ram to 896K, Eprom to 256K) From £ 79.00 
For Option Details on any product send $.AE. 


Serial 3 Button Mouse 
Remote Infra Red Mouse 


BS 
$55 


Externally fitted into SER2, comes complete with interface and software, No 
Internal fitting required, 3 button mouse gives 5 more functions than the QIMI. 


NB. We still have lots of QLs, 1 & 2 Mb disk drives, peripherals and components. 
See previous adveris or contact us for details. 


18-2] MISBOURNE HOUSE 
Se] CHILTERN HILL 
"——_ CHALFONT ST.PETER 


AU SLY SUE 
(OD) Ter. 0753 888366 


Payment terms: 
CWO, Access, VISA et cetera 
Cheques - allow 10 days 


oe 


Delivery: 


Carriage - £9 Postage - £4 Sq 
Product subject to availability, E&OE. E E: 
FAX: 0753 88714 


TF Services FF 


MINERVA 


The ULTIMATE operating system upgrade 
HRD MINERVA row with battery for 256 bytes 
ram CRASHPROOF clock & interface <I*C) for 
Lrobots etc. Can autoboot from battery ram. 
0 common’ to MKI/MKIT) $ 


Multiple Basic?’ Faster 
of Lightning) -string 


» Rest FREE 
sk or 2 mdys) 
Original MKI £46 
ALL VERSIONS FULLY GOLD CARD COMPATIBLE 


BULLETIN BOARD 


OBES - The first UK QL scrolling bulletin 
board. Now even lurger with international 
ECHOnei! and 18mb of files including 
the WHOLE King Jomes’ bible!> 


071-706 2379 V21/23/22/22b1s 24hrs 


QuaLsof t 


Viewdata/VTS2-UT100 QL TERMINAL EMULATOR 


Multitasking for electronic mail, PRESTEL etc, 
CET download. Compatible with Tandata @connect 
OL moden/modaptor, Use Oconnect RS2320 to drive 
untist ine Comprehensive AS manual. 


Software (3.5" or mdy) & manual £30 
FILE TRANSFER - to transfer text AND programs 
error free CXMODEM) betueen computers 


Available for IBM compats, ATARI ST & Sinclair OL 
Connects to Psion range with RS232C comms link 
Softuare £7.58 per m/c. Cable £18 ‘name 2 m/cs) 


All prices include VAT and postage in the UK 


12 Bouverie Place, London U2 188 


HERMES 


A replacement QL coprocessor (IC 8049 IPC) 


Do you get keyboard bounce? 
Do you find fast serial input unreliable? 
Do you want to run an HST 14460 bps noden? 


IF you can say YES to any one of these, then 
this is a product you have been waiting For 


Gives up to 19288 bps RELIABLE serial inout 

+ Independent baud rates 

Stops keyboard ‘bounce’ (unwanted repeat chrs) 
ol 


mproves ‘fuzzy’ and ‘random’ sound 
extra input and output lines 


fvoked more safely 


FITTING is a simple job. Simply remove the 
GL top (8 screws) and replace the chip marked 
"8849° next to microdrive 1, 


PRICE (including manual & softuare) it 


Faulty QL boards ¢excl plug in ICs) 
Keyboard membrane... €8 Circuit diags... 
68808 cpu.. » £8 1377 PAL, . 
JM rom set, E10 Power supply 
8302 ULA £10 8301 ULAR, 
8045,, » £8 MOU ULA 


Other components (sockets etc)... 


QL REPAIRS 


QLs tested with Thorn EMI test rig 


and ROM softuare 
(MDU harduare extra if required) 


E27 - 6 month guarantee 


MAIL ORDER ONLY 


71-724 $053) 


SCROLLING BBS FOR ORDERING/QL HELP and FAX - 871-706 2379 


Sinclair/QL World August1992 


EEC Ltd. are continuing to produce their improved 
MGT Lifetime Disk Drive, which is now sold as the 
EEC Universal Disk Drive. A 1 MB version is 
available at the reduced price of £70 (VAT-inclusive), 
and the 2 MB version at £90, which is half the original 
MGT price. The price includes an instruction book, a 
free 3.5 in disk, and a connecting lead for any one of 
the following computers: Sinclair Spectrum, QL, IBM 
PC or compatible, BBC, Amstrad, Atari, and Amiga 
computers. Extra leads are £12 each. 

A kit of parts can be bought, consisting of a case, a 
transformer, DIP switches, and a data socket, for £23 
plus £5 postage. This is for users wishing to make 
their own drives or customised units. EEC can also 
supply | MB and 2 MB drives at £29 and £49 re- 
spectively, and power supply units for 5V drives at 
£6. 

The 1 MB version will format up to 720 K with 


the 8049 


Hermes is a replacement Intelligent Peripheral 
Controller (ipc) chip developed for the QL by 
Minerva’s Laurence Reeves, and marketed by 
Minerva’s regular agent, TF Services. 

Hermes is designed to replace the QL’s own ipc, 
the IPC 8049, which has presented users with certain 
problems since the QL was invented. Among the 
best-known problems with the original IPC 8049 are 
poor handshaking on serial input (sometimes requir- 
ing a full reset); keybounce, especially with early PC 
add-on keyboards; lack of independent baud rates; 
inaccurate sound functions. 

These are among the problems which Hermes cures. 
The literature lists more precisely: two-key rollover, 
even with Shift; fully reliable serial input up to 
19200 baud with one stop bit, assuming that the IC25 
output buffer is working correctly and handshaking 
is enabled at both ends, and connected (check your 
serial cable and make sure the ports are open); differ- 


Sinclair/QL World August 1992 


CEN 


Hermes steps in where 


double-density disks. The 2 MB version (which also 
reads double density) will format up to 1.44 MB, provid- 
ing the system will support it. 

EEC are still supplying QL and Spectrum computers 
and hardware including microdrive expansion kits, 
microdrives and parts, as well as cartridges, although 
these are no longer manufactured. All prices include 
17.5% VAT. 

Bill Richardson is also stocking the Serial 3-Button 
Mouse at £45, and the Infra-red Remote Mouse at £55. 
These fit externally into Ser2 with no internal fitting | 
required. They come complete with interface and soft- 
ware. According to advance publicity, the 3-Button 
mouse offers five more functions than the Qimi. 

Orders and information from 

W N Richardson & Co., 18-21 Misbourne 
House, Chiltern Hill, Chalfont St. Peter, Bucks SL9 
SUE. Tel. 0753 888866. 


ent baud rates for each serl and ser2 input lines, and 
separate from output (can be used to drive a serial 
mouse and a printer from serl simultaneously. Open/ 
closed status of serial ports can be read; code to handle 
three spare I/O lines (one is used by the Qview capsled 
kit) Three other input lines can be read; keyclick toggled 
on and off; Reset/INT77 invoked more safely; function 
to return ipc version number. 

Fitting involves removing the top of the QL and 
replacing the IPC chip. full instructions are included. 
Also included is a small extensions file to be loaded 
with RESPR. 

The Hermes package costs £25 inclusive of chip, 
disk, VAT and UK postage, from TF Services, 12 
Bouverie Place, London W2 1RB. Tel. 071 724 9053. 
Personally, we would wrap up our old chip and keep it 
in a safe place, rather than filing it where Laurence 
recommends - why contribute to a landfill when you can 
clutter your cupboards? 
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PEN WHANNEL 


Open Channel is where you have the opportunity 
to voice your opinions in Sinclair QL World. 
Whether you want to ask for help with a technical 
problem, provide somebody with the answer, or 


just sound off about something which bothers you, 


write to: 


Open Channel, Sinclair QL World, The Blue Barn, 
Tew Lane, Wootton, Woodstock Oxon. OX7 1HA 


Earlier this year you asked about 
an assembler and a C compiler for 
an unexpanded QL. The only as- 
sembler I have ever used on the 
QL is the Assembler Workbench, 
published originally by Talent. It 
is well adapted for the unexpanded 
QL. Not only that, but it comes 
with excellent on-line help, and a 
good range of monitor and debug- 
ging facilities. It also has a great 
little text editor with it, for writing 
programs. L use this to write Forth 
programs as well as assembler 
listings. It lacks some of the facili- 
ties of bigger and more expensive 
packages. The most important 


Services. 
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ATE TH 


Editor’s notebook 


Summertime, and the living is rainy. But 
not as quiet as we normally expect in 
July-going-on-August. This is no doubt a 
side-effect of our many moves with letters 
arriving thick and fast, either wanting to 
know what is going on, or congratulating 
us, or both. PaulinE and Fran are correct- 
ing the Subscribers list by hand, which 
may mean more rational overseas ad- 
dressing in the future. 

The hardware and software community is 
also hard at work. In particular we have 
new software news from Jochen Merz in 
Germany and Ergon Developments in 
Italy. We also have (slightly delayed) 
news of the Hermes replacements IPC 
chip for the QL, produced by Minerva’s 
Laurence Reeves, and marketed by TF 


| won't pretend that we’ve entirely caught 
up. We're behind with reviews and the 

open Channel proofs are emerging in a 
funny order - but we’re getting there. 


factor is lack of macros. However, 
you only really need these if you 
are writing big programs which 
would require memory expansion, 
and so you would not use them on 
an unexpanded QL anyway. As- 
sembler Workbench has never 
lacked in any facility I found any 
need for, and as it seems to be 
cheaper than any other assembler, 
it is almost certainly the best buy 
for someone who has an 
unexpanded QL. 

As for C compilers, I have 
dabbled in C for a couple of years 
now, both on the QL and on IBM 
compatibles. But I have not writ- 
ten any serious program in it. It 
clearly is a very good language for 
those involved with large pro- 
gramming projects, if only because 


of the enormous libraries of rou- 
tines available to start you off. But 
for small programs (less than, say, 
32K) it is much too complicated a 
process to go from source code to 
final program. Itis somuch quicker 
and easier to program in assem- 
bler, or Forth, or even Basic, and 
then compile the Basic. 

To use almost any C compiler 
will require memory expansion, 
and even if it works with an 
unexpanded QL, it is unlikely to 
be very useful. However, if I were 
going to start experimenting with 
C on the QL, I think I would get 
the public domain C68 C com- 
piler from Qubbesoft. It’s good, 
it’s continually getting better, and 
it’s free (apart from copying 
charges). It’s the only one I have 
actually tried on the QL, although 
I have tried several C compilers 
for IBM compatibles. 

Alan Bridewell 
Swindon 


Are you a QL criminal? In you 
live in that little island north of 
France, and have a personal com- 
puter then, undoubtedly, you are. 
David Drysdale must have diffi- 
culty speaking with his tongue 
firmly in his cheek. 

I bought my QL in March 1985, 
and used it for writing letters. The 
first thing I did was to produce a 
cartridge with names and ad- 
dresses, so that I could print en- 
velopes and merge addresses for 
business letters, without having to 
type them. I now have 600 ad- 
dresses on three disks, duplicated, 
of course. 

I can openly state the above, 
because in Andorra we do not have 
such an act as the Data Protection 
Act of 1984. For the last two 
months, doubtless in all innocence, 
there have been articles in Quanta 
specifically trying to teach users 
how to enter addresses and tel- 
ephone numbers using Archive. 

The greatly-increasing use of 
electronic diaries and notepads 


means that people other than com- 
puter users are doing the same, 
with the addition of telephone 
numbers, what the person or 
company is or does, their part- 
ners’ names, etc., etc. PC pro- 
grams are commercially available 
for this purpose. 

The act was made law for very 
good reasons, but at the time the 
use of personal computers had not 
taken off as it has since. The act is 
certainly still needed, but it must 
be amended so that you are not all 
criminals in future. 

Ithink that computer magazines, 
computer manufacturers, and 
others concerned should write 
letters to the newspapers, the 
Government, lobby their MPs, and 
generally highlight the absurdity 
of the particular section of the act. 

This is intended to start the ball 
rolling, instead of everyone be- 
having ‘criminally’ and doing 
nothing to get the situation 
changed. 

Gil Lamb 
La Massana 
Andorra 


Some news that might interest QL 
World readers. Any QLer who 
has access to the worldwide net- 
work that links many mainframes 
should get in touch with Giuseppe 
Zanetti who is collecting the names 
of QL users. His e-mail address is 
‘beppe @alessia.dei.unipd.it’. He 
will supply a list of names and e- 
mail address on request. There are 
only about 30 so far, short of the 
100 required to setup anews group 
devoted exclusively to the QL, so 
we have decided to post QL-re- 
lated news items on 
‘comp.os.misc’. Professor Timo 
Salmiin Finland has also made his 
QL programs available on an 
anonymous FTP - server, 
‘garbo.uwasa.fi’, these can be 
downloaded over the net, and he 
will also accept files from others 
to add to the collection. 

I haven’t attempted to explain 
the details of how to access the net 
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since I imagine those of your 

readers who have the facility will 

already know how to do it - and 

anyway, the procedure varies 
from machine to machine. 

Howard Clase 

St John’s 

Canada 


In Sinclair QL World in April 
1992, on page 12 under the head- 
ing ‘Byron’ I read for the first 
time in my life - of the existence 
of a JSU rom in a QL. At the 
moment [also know of aJMrom, 
a JS rom and an AH rom. 
Which rom is the best? Which 
romis the worst? How many types 
of rom exist in total? Can some- 
body give me an answer to these 
questions? 
Thanking you in advance, I 
remain: 
M L Huppe 
Lauwerecht 201 
515 GR Utrecht 
The Netherlands 


Comment: Ifanyone can compose 
the short answer to this broad 
and rather personal question, we 
will print it in Open Channel. 
Meanwhile, we will consider the 
possibility of publishing the long 
answer, but not in Open Chan- 
nel. 


Slashed 


Calloo, callay, oh frabjous day, 
and all that. Itis great to have you 
all back in circulation. Long may 
you continue so. 

Only one thing clouds my view: 
The QL remains so exactly 
matched to my needs that I find it 
difficult to believe that anyone 
else could find a use for it. I live 
in terror that the bubble will burst 
and I will wake up one morning 
to find myself the lone surviving 
user. 

But I am not writing only to 
congratulate: there are two other 
matters, less important but which 
should nevertheless be brought 
to your attention. 

The fount used for the listings 
in Open Channel is not wholly 
suitable. The minus signs are al- 
most invisible; the distinction 
between colon and semicolon is 
very fine; and the zeros really 
ought to be slashed. 

Which brings me to the second 
problem which concerns me. You 
printed a scrap of my own code 
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on page 15. Sadly there is a translit- 
eration error. A double vertical line 
(_ ), signifying a bitwise OR, has 
become a double underscore in line 
1040. It may have been my fault: 
my printer prints a vertical line as a 
broken vertical line, and it is my 
usual habit to fillin the gap by hand. 
It is possible that I omitted to do so. 

If anyone should need a listing 
straight from the source, I would be 
happy to supply it. 

Funny to see your comments on 
the colour of the fields. In my pre- 
war East Anglia youth they were 
bright yellow too, but a much 
‘cleaner’ colour: they were grow- 
ing mustard for the Colman mills in 
Norwich. 

Please keep going. Your efforts 
are greatly appreciated. 

P H Tanner 
Glasgow 


Comment: Having had another look, 
I am going to vote a disagreement 
with you on the clarity of the listings 
print: I find the colons and semico- 
lons are distinct, and the minus 
signs quite clear, if a bit small. The 
0 and the O are among the most 
distinct I have seen in any typeface. 
However, this is the first comment 
on this subject I have had from a 
reader, and I would be very pleased 
to see further opinions. 

I may have read the missing ver- 
tical lines as broken lines, but the 
underscore is a translation error - 
it was in order last time I looked at 
it. I think this is one of the few 
characters which is going to go on 
giving us trouble. 

It’s a bit sad that oilseed pollen 
upsets so many people, especially 
as it’s a close cousin of mustard, 
and surely no more non-organic 
than hay (as in ‘hay fever’, of 
course). A friend from Norwich 
says: ‘I’dappreciate it more if there 
wasn’t so much of it.’ 


Having recently purchased a Sony 
camcorder (from Comet, with a 
subsequent refund of over £50, be- 
cause of the price of a competitor), 
I thought it might be possible to do 
titling with the QL. I contacted 
Jonathan Oakely, who explained 
that as far as he knew, it was not 
possible for the QL torunaGenlock 
system (which is necessary if you 
want to merge two video signals). 
I then tried using Page Designer 
2 to make titles and photograph 
them from the monitor, not very 
successfully due to reflections. With 


100 WMON 
110 WINDOW #0;512,256,0,0 
120 CLS #0: REMark BLANK SCREEN 


130 WINDOW #0;512,10,0,246:PAPER #0,0:INK #0,2 
140 WINDOW #1;448,60,32,0:PAPER #1,0:INK #1,7; REMark INPUT WINDOW 
150 WINDOW #2;448,186,32,60:PAPER #2,0:INK #2,7:REMark DISPLAY WINDOW 


160 CSIZE #1,3,1 

170 CSIZE #2,3,1 

180 DEFine PROCedure RULE 
TSOPRING Fee eee 
200 END DEFine 

210 DEFine PROCedure CLSALL 

220 CLS #1:CLS #2:CLS #0 

230 END DEFine 

240 ERT HOT_REMV (C) 


250 ERT HOT_CMD (‘C’,’CLS #1') : REMark CLEARS THE INPUT WINDOW 
260 ERT HOT_CMD (‘I’, input’”’;prg$’,’ print #2,prg$’) 


Toolkit 2 users should lose line 140 and replace 250 and 260 with: 


250 ALTKEY ‘C’,’CLS #1'” :REMark CLEARS THE INPUT WINDOW 
260 ALTKEY ‘I’,’input””;prg$’,’ print #2,prgs’,”” 


further thought, it was obvious that 
a monochrome signal could be used 
as it was the required composite 
video signal, but experiments in 
linking the monitor lead to the 8mm 
video recorder via the edit unit not 
only gave the title, but also all the 
unwanted rubbish on the screen. 

It became apparent that what was 
needed was a completely blank 
screen which was the full 512 by 
256 pixels. The nearest I could 
achieve was to have a one-line (512 
by 10 pixel) window 0. Paper 0, Ink 
7, Csize 3,1: a nine-line (448 by the 
remaining 186 pixels) window 2. 
With no borders, this gives a blank 
screen and the red ink on black in 
window 0 makes any typed-in com- 
mands almost un-noticeable on the 
video screen. The 448 width of win- 
dows was arrived at by experiment 
in order to keep the characters away 
from the edge of the screen, which 
however led to another small prob- 
lem, which was easily solved. A 
strip each side of the windows re- 
mained uncleared. To remove this, I 
decided to first define window 0 to 
the full 512 by 256 pixels, CLS #0 
and then redefine the windows. 

Input into window 1 is transferred 
to window 2, and then CLS #1 clears 
window | (Alt-C). Two procedures 
are used: Rule is a rule which ap- 
pears in window 1 to facilitate 
spacing and Clsall clears all win- 
dows. Although limited to the QL’s 
character set, this is a very cheap 
option for titling (character genera- 
tors start at £150). If you think 
computer equipment is expensive, 
try video: camera £395 to £1999, 
video recorder £220 to £1799, and 
an editor with mixer and fader/en- 


hancer facilities £59 to a full editor 
system including character genera- 
tor with memory £4999. Of course, 
my equipment costs the lowest of 
these prices. I hope the listings will 
be of use to those who can only 
afford the older type of cameras 
with no built-in titling facility. 
Peter Rowell 
Quanta and Cambridge 
Archimedes and 68 Group 
(Case) 


Referring to Peter Tomlin’s letter 
(), Abacus 2.00 accepts the dollar 
sign $. What this does is to make 
cellreferences absolute. For exam- 
ple, if cell Al contains 10, cell B1 
contains 20, and cell C1 contains 
$A1 + Bl, cell Cl will show on 
screen the value 30. Echo cell Cl 
(use F3:E:C1 across range C2:C4) 
and cells C2 to C6 will now contain 
the value 10. If you move the cur- 
sor onto cell C2 (for example), in 
the bottom left of the screen the 
formula $A1 + B2 will appear- Al 
is an absolute reference, whereas 
B1 was taken as a relative refer- 
ence. 

To use the dollar sign, type it in 
as part of the formula, for example: 
B1 + B1 * $C2/100, entered into 
cell D1, could be used to calculate 
a VAT-inclusive amount, if C2 
contained the current rate of VAT. 

Rich Mellor 
Walsall 
W Midlands 
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MEETINGS 


Dilwyn Jones reports from the re- 
cent Quanta workshop in London 


The recent workshop on the 
30th of May 1992 inachurch hall 
in North Kensington was organ- 
ised by the London group affili- 
ated to Quanta, the UK QL User 
Group. The venue was easily 
accessible both by car and by 
public transport. 

Quanta workshops are mini- 
shows where members (and often 
other users) can come along and 
meet other QL users, meet QL 
traders to buy items for their QLs, 
ask questions, get help with their 
problems and attend informal 
lectures and discussions organ- 
ised ona wide variety of subjects. 

Non-members can come along 
too - admission is usually free 
and there is no obligation to join 
Quanta, although you may want 
to do so when you see all the 
activity and benefits which can 
be obtained from membership of 
the group. 

Most of the well-known QL 
traders came along to set up shop, 
including Digital Precision, 
Miracle Systems, DJC, EEC, 
Qubbesoft, QBits, Liberation 
Software, CGH Services, CL 
Systems and Software 87. 

Freddy Vachha of Digital 
Precision gave an all-day dem- 
onstration of his company’s soft- 
ware for the QL and talked at 
length on a number of subjects. 
Miracle Systems showed their 
range of hardware for the QL. 
The Gold Card is now apparently 
selling very well following the 
recent price reduction to £225. 
Miracle were displaying what I 
think was the smallest QL serial- 
to-parallel printer port converter 
I have ever seen - the circuitry 
was small enough to fit into the 
cover of the printer connector. 
The device I saw was only the 
prototype unit, but we believe it 
will be on sale soon. 


Trump swap 


Miracle may be launching a 
number of new QL products this 
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year, so we eagerly await them. 
Their well known Expanderam card 
and Trump Card will now be pro- 
duced and sold by Qubbesoft - Ron 
Dunnett told me that the good news 
is that there will be a modest price 
reduction on these two items. See 
this month’s QL Scene for more 
details. 

Fred Toussi of Software87 dem- 
onstrated and sold the Plus4version 
of the word processor text87. This 
is aremarkable program, well wor- 
thy of ademonstration the next time 
you see Fred at a QL show. 

CL Systems exhibited their 
CQV1 QL Video Digitiser, now 
available in a version compatible 
with the Gold Card. Mr Lang sam- 
pled pictures onto disk for custom- 
ers, using a video camera. TF Serv- 
ices were selling anew device called 
Hermes. This is a direct replace- 
ment chip for the 8049 IPC unit in 
the QL, providing a number of im- 
provements. It helps to solve the 
serial input problems on the QL, 
giving split-input baud rates on both 
serial ports, and much improved 
keyboard de-bounce. It can provide 
three input/output lines and many 
more features. The price was £25.00. 
Contact TF Services for further 
details. Tony Firshman said that 
both the standard Minerva eprom 
and the MKII version are still sell- 
ing well. 

CGH Services’ stand had a 
number of leisure programs for the 
QL andaselection of QL magazines 
such as the QL Technical Review, 
QL Leisure Review and the Inter- 
national QL Report, an informative 
magazine originating in the USA, 
but with subscribers all over the 
world. 


Second users 


Several traders were selling a 
number of second-user bits and 
pieces for the QL. QBits and 
Qubbesoft, for example, both sold 
various items of software, hardware, 
spares and old books and maga- 
zines - several visitors said it was 


worth the trip just to browse through 
the contents of such stands. 

An interesting device was avail- 
able from the QLEA stand. QLEA is 
the East Anglia Quanta sub-group. 
The QL ROM Switching Board is a 
small PCB which fits inside the QL 
and allows you to have two QL roms 
present, including a Minerva, which 
canbe selected at the flick ofa switch 
and a reset. A two-colour led indica- 
tor tells you which rom is in use. The 
benefit of this to users and software 
writers is that software testing is sim- 
plified - there is no need to dismantle 
your QL to change roms to test a 
program, or run a program which 
will notrun with a Minerva installed, 
for example. The device is modestly 
priced at £25.00 plus a fitting charge 
(unless you fit it yourself). 


Various talks took place on the 
stage area during the day, including 
Dave Walker’s discussion of his 
excellent public domain C-68 C 
language compiler for the QL and 
Chris Boutal’s talk on the fascinat- 
ing subjects of Genealogy and his 
best-selling QL Genealogist pro- 
gram. Fred Toussi also gave a talk 
on text87 Plus4. 

Due to the bad weather all over the 
country during the week before, this 
was not the best attended of Quanta 
workshops, although they are al- 
ways great fun to attend. Quanta 
workshops are planned for Newcas- 
tle-upon-Tyne, Nottingham and 
Thetford later this year and possibly, 
by the time you read this, more ven- 
ues will have been added. Why not 
go along and join in the fun? 


TheSpectrum's 
Birthday 


Simon Goodwin held a birthday party 
for the Sinclair ZX Spectrum - 10 


years old this May. 
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Britain’s best-selling computer, 
the Sinclair ZX Spectrum, cel- 
ebrated its tenth birthday this May, 
at a party organised by ZX enthu- 
siasts in Cambridge, the Spectrum’ s 
birthplace. 

The Spectrum followed Sinclair’ s 
ZX 80 and ZX 81 computers, and 
was known internally as the ZX 
82. A decade on, after some seven 
million sales of Spectrum vari- 
ants, ZX 92 was the obvious name 
for the anniversary re-union. 

Spectrums, emulators, clones 
and eager users gathered at the 
Boat House pub, beside the river 
Cam. Star guests included John 
Mathieson, who joined Sinclair 
Research in 1981, wrote the origi- 
nal Spectrum brochure and tested 
the ZX rom before its release a 
decade ago. MGT founder Bruce 
Gordon brought old prototypes of 
his SAM micro, the true successor 
to the Spectrum, and new hardware 
under development. 


Party music 


The party featured a soundtrack 
of Spectrum-generated music, in- 
cluding Prokofiev’s March of the 
Capulets rendered for 128K sound 
chip by muso Jon Bates, and 
Overture for Toad, an atmos- 
pheric MIDI sequence in the style 
of Philip Glass. 

Cheetah’s excellent Specdrum 
was used on many tracks, as were 
the RAM Music Machine and 
home- brewed software for effects 
and digital delays. Coventry band 
Relevant POS contributed catchy 
pop via their home-made interface 
for Wasp synthesisers, making a 
personal appearance with fans in 
tow. 

Jamaican reggae and ska were 
represented by Norman Hall, plus 
guitar polemic from T1/TO, with 
former Crash and Sinclair User 
minion Garth Sumpter on vocals. 
Blues songs from Mel Croucher of 
Automata recalled the spirit of ZX 
Microfairs. Even Doctor Who 
made a contribution, in the shape 
of an out-take from Automata’s 
classic Deus Ex Machina, narrated 
by Jon Pertwee! 

John Mathieson brought two rare 
variants of the Spectrum: a white 
48K model, produced to celebrate 
the millionth machine produced, 
and a unique Spectrum Plus, also 
moulded in white plastic as an ex- 
periment when Sinclair considered 
changing the case colour for the 
new model. 

The original ‘Issue One’ Spec- 
trum made an appearance, with 
the last-minute ‘dead cockroach’ 
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modification exposed - an extra 
chip soldered upside down beside 
the main logic array, needed to 
make early production keyboards 
work. 

Downstairs in the bar another 
Spectrum development was earn- 
ing its living. Delegates spotted 
the Treble Top pub game, a com- 
mon arcade machine built around 
the Flare One circuit board. This 
super-Spectrum was invented in 
1987 by three former Sinclair de- 
signers. It uses the same Z80B 
processor as the SAM Coupe, plus 
custom graphics and sound hard- 
ware. 

The party attracted many lumi- 
naries from the Spectrum sub- cul- 
ture, with a great spread of back- 
grounds and ages. The youngest 
delegate was no older than the 
computer, while the oldest had re- 
tired before the ZX range was born. 

Fanzine writers included John 
Wase and Nev Young of Format, 
David Ledbury of ZAT, veteran 
adventurer Margot Porteus and 
Fractal guru Ettrick Thomson. 
Commercial competition was for- 
gotten, as Glen Cook and Andy 
Wright discussed contrasting ap- 
proaches in their SAM Game De- 
sign suites, due soon from Betasoft 
and Glenco. 

ZX 92 was arranged by 
Sinclairphile and one-time Crash 
tipster Simon N Goodwin (me), 
and recorded for posterity by local 
media and Jon Pillar of Your 
Sinclair. Awards of software, 
publications and hardware were 
shared in a Spectrum-moderated 
draw. Top prize was a rare and 
valuable Currah Microspeech 


voice synthesiser, donated by 
Betasoft. 


Spectrum CD 


Codemaster’s Spectrum Com- 
pact Disk package attracted atten- 
tion. This reads games from a 
normal CD player, linking the 
headphone socket to the Spectrum 
joystick port. You get 30 machine- 
code games, including several big 
hits, for £20 including the inter- 
face, ably demonstrating the size 
and economies of scale of the 
Spectrum market. 

The range and quality of Spec- 
trum software has encouraged mi- 
cro users to develop ‘emulation’ 
packages that let them run ZX pro- 
grams on other computers. William 
James’ excellent Spectrum emu- 
lator for the Sinclair QL was on 
display, running ZX BASIC and 
popular games from QL disk. This 
emulator should reach the public 
domain once documentation and 
software to transfer ZX memory 
snapshots from disk have been fi- 
nalised. 

Already, Dave Barker’s public- 
domain QSPEC software is capa- 
ble of reading ZX cassette files 
and screens into memory, via the 
QL network port. QSPEC is avail- 
able from CGH Services and other 
PD libraries. Spectrum file con- 
version programs are also avail- 
able from Quanta (disk Comms 
Xfer 2) and CGH Services (Con- 
nections disk 1). 

The Commodore Amiga has ZX 
emulators of its own, developed 
by Digimail of Milan, but the most 
technically impressive demon- 


MEETINGS 


stration at ZX 92 was a double- 
emulation, with the QL Spec- 
trum emulator running sweetly 
under the Public Domain Qdos 
emulator for the Amiga!>The 
Qdos emulator was developed 
by Rainer Kowalik of Berlin; it 
lacks sound and supports only 
four colours, so some of the 
Spectrum hues appeared as stip- 
ples, but otherwise the double- 
emulation seemed perfect. 


ZX on the PC 


Andy Wright’s ZX emulator 
for the Amstrad CPC range made 
a showing, alongside similar 
programs for the SAM Coupe, 
which was designed to run 48K 
Spectrum programs from the 
start. Bruce Gordon brought the 
original SAM prototype, hand- 
built on four circuit boards, with 
hundreds of TTL chips standing 
in for the custom ASIC in pro- 
duction models. He also dis- 
played the latest model, shorn 
of MIDI and TV circuits to fit a 
paperback-sized board, and in- 
tended for process-control ap- 
plications. 

No less than three emulators 
for IBM PCs turned up at the 
party, via Germany, Spain and 
Holland, along with hardware 
emulators for minority British 
designs like the Memotech MTX 
and Tatung Einstein. It is still 
early days for emulation software, 
and you need a fast processor to 
match the speed of the original 
micro, but the future looks rosy 
as programs proliferate and chips 
rise to the challenge. 


Text 87 
Into the 90s 


INFORMATION 
Program: Text87 Plus-4 
Price: £79 

Supplier: Software87 
33 Savernake Road 
London NW3 2JU. 


peed is a good selling point and has 
Speen much emphasised in connec 
tion with wordprocessors. This review 
was written on the basis of experience 
running text87 Plus-4 on a JS QL with a 
Mark 2 Gold Card and ED disk drives. 
There was also another ‘tweak’ in the sys- 
tem, in the form of the latest version of the 
Lightning display-enhancer program. 
These things smarten up the behaviour of 
almost any program, anditis easy to forget 
that life isn’t quite so much ‘in the fast lane’ 
when your system doesn’t have them. It is 
safe to say that lack of speed should not 
_seriously trouble any user of Plus-4, though; 
itgets on with the job without painful pauses, 
in a way that Quil/ cannot manage. 

The basic requirements for text87 Plus4 
are a QL (or Thor or Atari ST with QL 
emulator) having at least 256 KB of expan- 
sion memory in addition to the original 128 
KB, one disk drive, and a display which can 
handle Mode4 text. The program version 
referred to here is labelled ‘text87p4E3’ 
(‘T87’ from here on), the final digit indicat- 
ing release 3 of the Plus-4 program, cur- 
rent in early July 1992. This version has 
several enhancements, compared to the 
initial release version. 


Not cosmetic 


It is clear as soon as you start this pro- 
gram that it is no mere cosmetic face-lift of 
version 3. There is similarity in the menu 
structure and options, but a lot of changes 
have been made. That should not put off 
users of the existing versions, though, as 
they will find the style is essentially the 
same. There are simply more facilities 
available, and some of the existing ones 
have been made more usable. 

There were problems with the initial re- 
leases (several different versions were re- 
ceived during the period of this review), but 
the complaints of users were heeded and 
the faults quickly rectified. No serious bugs 
were noticed in the final review copy. Files 
saved with very early copies have to be 
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loaded into the current version as Ascii 
text, and certain random characters at be- 
ginning and end of the text need to be 
deleted, to ensure compatibility. 

The basic formula is still the same. A 
‘real life’ screen, with dimensions in milli- 
metres or inches rather than in terms of 
fixed-pitch characters, different display 
founts to show both sizes and attributes 
such as italics, automatic reformatting when 
changes are made to text or to ruler pa- 
rameters, ready-made printer-driver files 
to relieve the user of any fiddling, proper 
display of different justification modes and 
of proportionally-spaced characters, and 
on-line spelling checking. The new features 
include multiple windows, for 1 view of up 
to eight documents, or eight views of one 
document, or any combination. The win- 
dows are quite independent and spelling 
can be checked in all of them. 


Getting started 


Getting started is straightforward. A rou- 
tine is provided to enable creation of a 
working copy of T87, setting the default 
devices, and selecting a printer-driver. The 
default Layout, Ruler and Typestyle settings 
can be altered by the user. Allowance is 
made in printer-drivers for non-printing 
areas on the paper; you need to bear this 
in mind when setting margins. 

There is a fairly comprehensive on- 
screen Help feature, which should meet 
with general approval. The help text is 
initially loaded from disk, but then remains 
in memory (unless deliberately unloaded 
to release memory) and further use doesn’t 
entail disk activity. F1 brings up the help, 
which is paged-through by means of the 
Shift-Up/Down cursor keyings. There are 
over 40 screens of help information, with 
eight lines on each, andthe first screen you 
get is related to the commands menu you 
are currently using. Answers to most obvi- 
ous questions should be obtainable from 
here. 

T87 instruction booklets have met with 
complaint in the past and, in my experi- 
ence, the best approach was to read all 
through the booklet - several times - before 
getting stuck into using the program. Some 
of the terms used were (and still are) un- 
familiar, andthe general style of the program 
was quite a bit different from Quill (which 


Bryan Davies at last 
investigates text87 
Plus-4 in depth - 
delayed, but thor- 
oughly stripped 
down and cleaned 
up. He likes it. 


was all most of us had met previously). The 
new booklet is well laid-out and clear to 
read. There is a Contents list at the front, 
but no Index (one is likely to be added, 
though); even in a relatively small publi- 
cation, much time can be wasted looking 
for references to a particular word in the 
absence of an index. 


Two menu structures 


As a sign of understanding to those 
users who found the menu structure of 
previous versions too complex to work 
with, two menu modes have been provided. 
One causes all menu options to be dis- 
played, inthe appropriate groups, whereas 
the other deletes any options which are 
thought to be unwanted by users who are 
looking for only Quill-like commands. Thus, 
the File menu group - displayed when F3- 
F is pressed - shows Save / Load / Room 
/ Close / New / Merge / Export / Import / 
Zap, in its full form, or Save / Load / Room 
/Close in its short-menu form. The mode is 
set as a configuration default which re- 
mains in force until reset, allowing the user 
to work with the short set-up for a few 
weeks, while getting the hang of using the 
program, then switch to the full menus as 
confidence builds up. 

To alarge extent, the special features of 
the program can be ignored; you can just 
start typing once the working copy has 
been made. To do this is a sad waste of 
useful features, but you still have the greater 
speed and reliability, and the availability of 
a spell-checking function, when compared 
to Quill. 

Users of existing versions, and particu- 
larly those who have tried T87 and put it on 
one side, will ask whether or not functions 
are easier to use. Subjectively, my feeling 
is that there often tends to be one more 
keypress than is necessary to get the job 
done, but this is because of the effort that 
has been made to provide the maximum 
flexibility. The command names are mostly 
obvious ones, selection is generally by 
pressing the key for the first letter of the 
command, the Esc key takes you back one 
menu step (as it sensibly should do), you 
can restrict the number of menu choices 
and simplify matters by setting the ‘short 
menus’ default, the menu displays are clear 
and include some descriptive text. 
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For those who do not use a program 
every day - most of us? - the present 
structure is a sensible one, as you don’t 
have to remember obscure key combina- 
tions; the 12-hours-per-day user will wish 
for some shortcut keyings, that can be 
memorised, and you can use the toolkit 
ALTKEY command for this. 


Key combinations 


Comparison with Perfection is inevita- 
ble, but generalisation on the relative merits 
of the menu systems is dangerous; what | 
will say is that - for me - T87 makes life 
easier by avoiding the necessity for re- 
membering masses of key combinations, 
but more difficult by making access to 
commands less direct. How the individual 
user reacts depends to a fair extent upon 
his/her memory (or, indeed, the frequency 
with which the program is used). 

One drawback to earlier versions was 
the inability to have more than one page 
layout in a document. You can now set up 
to 64 layouts per document; this ought to 
satisfy most users. All Layouts within one 
document must use the same page size 
and orientation, though, so you can’t mix 
portrait and landscape pages. In addition, 
there can be several Frames per Layout, 
and there can be odd and even Layout 
pairs for facing pages. There can be differ- 
ent numbers of Columns in different 
Frames. The maximum number of col- 
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umns is 4; the gap between columns can 
be set. 

The use of frames is similar to that in 
DTP programs, and will facilitate the 
creation of fancy newsletters and such. 
Text normally flows from frame to frame, as 
it does with linked DTP frames. Another 
new feature is a page preview. While this is 
far from being exactly what some PC users 
have got used to in recent years, it is 
comparable to that provided by Microsoft 
Word, for instance. The text is shown as 
solid blocks and is unreadable, whatever 
the size, but it allows you to get a reason- 
able feel for how the page will look when 
printed. The function is surprisingly fast. 
The lack of readability is presumably a 
result of the low resolution of the QL screen 
and should not be taken as a deficiency in 
the program. 


Many windows 


The availability of several windows makes 
life much easier, when your WP operations 
are less than straightforward. The first re- 
quirement was to be able to look at two 
different sections of the same, large docu- 
ment simultaneously, and that has now 
been fully satisfied; you can have as many 
as eight windows onto the same document. 
For anyone who tends to grass-hop (that 
definitely includes me when at the key- 
board), an even more important require- 
ment is to be able to have several different 
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documents loaded at the same time, and 
be able to switch quickly between them for 
editing. 

Itis not an oddball need; for example, my 
current documents include this review, 
separate comments on T87 for the pro- 
grammer, comments on a beta-test ver- 
sion of another program, and a letter toa 
computer nut in Germany. There was a 
further document containing replies to 
readers’ letters a few days ago. All this is 
now possible, with T87. The windows can 
be sized and moved around. The ability to 
have a few words of many documents 
visible simultaneously does not cut much 
ice with me, as you get little enough text 
visible on a full 14 in screen as it is; but 
being able to switch quickly, and simply, 
between full-screen documents is very 
useful. 

lt is a pity that you cannot cut-and-paste 
directly from one document to another, but 
each document is unrelated to any others 
and you have to Export the desired block to 
(ram) disk, then Merge it into another docu- 
ment. But this does not apply to different 
windows onto the same.document - you 
can mark a Block in one, then switch to 
another one and Move or Copy the Block. 


Frame happy 


The message ‘margins too wide for frame’ 
may be painfully familiar to many T87 us- 
ers, but is presumably no more now, as the 
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program will carry on and print even if you 
have set the Ruler margins wider than the 
Frame width. You are warned that the 
results may notbe too satisfactory, though. 
There is a change in terminology for the 
Ruler, as Indent is now First Line Margin. 
Normal indented or ‘hanging’ paragraphs 
are no problem; the First Line setting speci- 
fies the indent of the first character of the 
paragraph from the start of the Ruler, and 
the Paragraph Margin sets the indentation 
of all successive lines, again from the start 
of the Ruler. The Ruler is now panned to 
the left to accommodate markers when 
they are placed beyond A4 width, making 
it easier to see what you are doing with 
wide layouts. 

We were all brought up on Quill, and 
came to expect to be able to look at a list of 
our document files, provided by Quill if the 
Load command was used. On ‘graduation’ 
to other programs, we found this facility 
absent, and we were forced to use Ctrl-C to 
go to SuperBasic to get a listing of files 
(displayed in a rather primitive fashion). It 
is good to see that Plus-4 has given us this 
important facility back again, in a very 
usable form. To obtain a listing of the files 
on the default drive; all you need do after 
selecting Load is press the up or down 
cursor key. The list contains only _T87 and 
_T91 (Plus-4) document files if you select 
Load, but all files are listed for other op- 
tions. Moving the highlight to the one re- 
quired, then pressing Enter twice, causes 
the selected file to be loaded. To check 
other devices, it is necessary to type in the 
device name (eg ram1_), then press the 
up/down cursor key. 

Among the features which will be praised 
or cursed, depending upon the outlook of 
the user, are retention of the last cursor 
position when a document is reloaded. To 
my mind, this is a very desirable feature, as 
there are few things more annoying than 
always being taken to the start of a docu- 
ment after an editing session has been 
interrupted. When you Save a file, you are 
not asked whether or not you wish an 
existing file of the same name to be 
overwritten. 

This certainly makes the save process 
faster, but can lead to heartburn. The cur- 
rent file name is displayed inthe menu area 
when you request a Save, so you can’t say 
you haven’t been warned. It is not unusual 
to load a file of one name, modify it, then 
wish to save it under another name, and 
this is possible. In this case, you are asked 
if you really want to overwrite any existing 
file of the same name. The chosen name 
then becomes the default for future saves. 
The programmer can’t win here, as it ap- 
pears impossible to satisfy both types of 
user, without complicating life for all. 


Block commands 


Returning to the matter of speed, one 
area where Quill lets the user down badly 
is the copying or deleting of blocks of text. 
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T87 has no trouble with these operations, 
performing them quickly. The macro cursor 
movementcommand Go Tohas been made 
available within Block operations; although 
simply holding the cursor down gets you to 
another place quickly, it is helpful in long 
documents to be able to specify the page 
you wish to go to, when making a Copy or 
Move. The Search, and Replace, com- 
mands are performed similarly fast. Large 
documents do not appear to slow these 
commands down enough to bother about. 

The spell-checking function utilises a 
version of the Q_Typ checker written by 
Tony Tebby. Although this is a separate 
function, the user is only aware of this 
initially, when the word list is loaded. 
Checking is called from the editing screen 
and behaves as an integral part of T87. 
The method of operation is that generally 
used on PCs, with the current document 
being checked as in a Search operation, 
each unknown word causing a halt and 
presenting the user with a list of options, 
one of which has to be chosen to set the 
process going again. The checker stops at 
anything which is not matched by an entry 
in its own word list. 

The options are Ignore, Browse, Edit 
and Add To Word List. Choosing Ignore 
causes the checker to pass on to the next 
unknown word, without doing anything with 
the current one. Browse produces a list of 
words which begin with the same three 
characters as the unknown one; if one of 
those words happens to be what you ac- 
tually need in place of the unknown one, 
you move the highlight (a red box, as in the 
other T87 functions) to the word and press 
Enter, whereupon the unknownis replaced 
by your selection. You are then taken back 
to the edit screen, and you can make 
further changes if required (such as if the 
replacement word needs an ending adding 
to it). Esc starts the checking process go- 
ing again. Edit puts you in the same posi- 
tion as after Browse, to allow you to make 
your own changes to text. 


Free movement 


There doesn’t appear to be any limitation 
on editing; you can move the cursor off the 
current line and go up or down the docu- 
ment, which can occasionally be desirable 
(maybe you’ve just noticed something 
which needs changing a few lines back). 

‘Add’ does what would be expected, 
putting the current unknown word into a list 
which is supplementary to the main word 
list. The supplementary list as well as the 
main word list is checked for unknowns 
during the remainder of the current session, 
but the supplementary list is not saved 
automatically unfortunately. You must use 
the Save option of the F3-Config-Spelling 
menu to have your words recorded for 
future use; you must also use the Load 
option from the same menu - or the initial 
menu shown when spell-checking is se- 
lected - to have the supplementary list 


available during the next checking ses- 
sion. This seems unwieldy, but is perhaps 
preferable to using the separate editor 
program to incorporate word lists into the 
main word list file, which is the recom- 
mended method of dealing with supple- 
mentary word lists. It was this latter op- 
eration which put me off using the spell- 
checker with the earlier version of T87, so 
things are better now. 

There is no concurrent spell-checking 
function, but that shouldn’t be missed by 
many users. As with many spell-checkers, 
upper case is inadequately deal with but, 
even so, it was surprising to find ‘germany’ 
accepted as correct, once ‘Germany’ had 
been added. One should bear in mind that 
the spell-checker is included in what would 
be a very reasonable price for the WP 
program alone; the checking performance 
is good enough to justify a much higher 
price, especially now the larger of the two 
word lists supplied is said to contain over 
200,000 words, and there are German and 
French lists as well as English, at no extra 
charge. 


The end of the Page 


The coming of hard disk, then the 3.2 MB 
floppy drive, brought with it the possibility 
of using sub-directories, a development for 
which most QL software was unprepared. 
Plus-4 supports the basic devices MDV, 
FLP, DEV, NET, RAM and WIN and inter- 
prets these letters followed by one digit and 
an underscore at the start of a file name as 
being a device name; that is, you can use 
DEV8_QUILL_ or such as a default stor- 
age device. 

A seemingly small thing like the end of a 
page can cause a surprising amount of 
discussion. The earlier T87 didn’t show the 
ends of pages unless you used the Go To 
Page command to force the display of red 
lines. Plus-4 is much more helpful, with 
three types of red line, for soft page breaks 
(where the program ends pages on the 
basis of the set page length), hard page 
breaks (where the user opts to enda page, 
regardless of length), and Section breaks; 
all are displayed automatically. The Sec- 
tion is a new concept for the QL, but is 
fundamental to the creation’ of many ref- 
erence documents. Books are frequently 
divided into sections which may well have 
their individual page-numbering se- 
quences. The simplest example is the first 
few pages - introduction, contents, ac- 
knowledgements, etc. They are not part of 
the main stream of the written text and 
should be numbered separately - i, ii, iii or 
similar. Page numbers can be printed au- 
tomatically, anywhere within a frame; a 
marker code is used to tell the program the 
desired position for the numbers. 

It is desirable to have all your ‘working 
conditions’ constant, and to have the cur- 
rent formats saved with a document. If the 
Ruler is displayed and the menu is at the 
bottom of the screen while you are editing 
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adocumenton one occasion, there is a fair 
chance thatis how you will want the screen 
to appear the next time you load that docu- 
ment. More importantly, the positions of 
margins and tabs, the type of justification, 
text founts and attributes, and such should 
be preserved, along with the cursor posi- 
tion. The F3-Config-Save option allows 
you to set your defaults for having the Ruler 
display on or off, having the menu dis- 
played at top or bottom of the screen, the 
amount of Room allocated to the next 
document, and the Ruler settings (margins 
and tabs), but you must use the F3-Config- 
Driver-Save option to preserve settings 
which are related to the printer, such as the 
default Typestyle. 


View screens 


In the gap between the introduction of 
versions 3 and Plus-4, much has hap- 
pened in the PC world, and it is no longer 
sensible to say that T87 is far better at the 
business of WYSIWYG. The pseudo-op- 
erating system Windows on the PC has 
spawned a collection of wordprocessors 
which make a fair job of displaying founts in 
the correct sizes and shapes, and making 
it easy to select them (trouble-free these 
are not, however.) There is also good 
agreement between screen and paper 
appearance of text. 

You may feel the need to do some ex- 


perimenting, to get the on-screen founts to 
match those which are printed, reasonably 
well. When your printer is a laser or ink-jet 
type, the wide range of point sizes can be 
only approximately represented on the 
screen. Matching is much easier to do 
when you have a simple 9-pin DMP printer, 
with few founts. Apart from the screen 
appearance though, you don’thave to worry 
about the effects of changing typestyle, 
because the program knows what you have 
requested, and takes care of the changes 
at print time. 

The main area in which the screen does 
not mirror the printout, and can cause you 
to mess-up printouts, is in line spacing. 
There is an option which allows you to 
switch on or off representative spacing on 
the screen, but this does not affect what is 
sent to the printer; that is set manually, on 
the Ruler. If you switch from, say, 10-point 
to 18-point, you’d better change the Line 
Spacing setting to match, or you'll have 
lines printing over each other. 


Running a test 


To provide a general check on capabil- 
ity, a test document was created, with 
another program and on another type of 
computer. The size of the file was close to 
300 KB, andit consisted of nearly 50 pages 
of text. There was no pointin trying to retain 
formatting information, such as founts and 


TEXT 87 


attributes, so the file was saved in ‘Generic 
WP’ format, which is similar to Ascii text (a 
blessing onits little head - Ed.). The file was 
then transferred to the QL by means of the 
XOver file-transfer program. Attempts to 
load it with earlier versions of Plus-4, using 
the File-Ilmport-Ascii command were met 
with refusal, and no indication of why. 

From previous experience, itlooked likely 
the problem was lack of working memory 
space, and possible confirmation of this 
was given when the Merge command was 
tried, a ‘short of memory’ message being 
displayed. The old memory size command 
has been replaced by the Room com- 
mand, which is not the same thing; it 
specifies the amount of extra editing space 
available for the next document, not the 
total memory for the document. However, 
the program was quickly modified to fix this 
problem and Import of such documents is 
now both simple and fast. The way the text 
appeared on the screen was a real pleas- 
ure - nothing funny aboutit, no non-printing 
codes, everything formatted as per the 
current Layout and Ruler settings, and it 
took only a few seconds. 

Many users will want to load Quill files 
and/or old _T87 ones. The Quill _DOC file 
chosen for checking was an old standby, 
nearly 300 KB in size with over 40,000 
words of text. It loaded with no bother, from 
the F3-File-Import-Quill command. The text 
attributes - bold, superscript, etc. - and tab 
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TEXT87 PLUS-4 NEWS 


This page is A4 Landscape, 
split into 4 columns, You 
could use a similar layout to 
produce a newsletter in A5 
size, with 2 pages of 2 
columns each printed across 
A4 sheets. By giving a little 
careful thought to page 
numbering, and turning the 
paper over to print on both 
sides, you can create a 
booklet by folding & stapling 
the sheets down the middle. 


The edit screen shows only 1 
column; successive columns 
are displayed one below the 
other. The new Print Preview 
function does show the 
columns correctly, though; it 
also shows the justification of 
the text, which is not always 
apparent in the edit view. 


There is a Gap function 
contained within the 
Columns option of Layout 
which allows you to put 
space at the middle of the 
page. As the gap has to be 
the same between every pair 
of columns, you can't set a 
decent space where the 
page will be folded without at 
the same time making the 
spacing between the pair of 
columns on each side rather 


too large. Its a pity 5 
columns aren't allowed, as 
that would enable the middle 
one to be left blank, but you 
could use 3 columns and 
settle for just 1 column on 
each AS page, using the 
middle one for separating the 
pages. 


There is another way of 
achieving the same result -- 
using Frames. The A4 
Landscape Layout could be 
used, but divided into 4 thin 
vertical frames. As frames 
can be placed where you 
want them, the spacing 
between one pair can be 
different from that between 
another pair. This approach 
should produce the better 
result, at the expense of 
taking longer. 


Even if you opt to use the 
Column option rather than 
Frame, you can still use the 
latter for any headers or 
footers you require. As the 
whole of the landscape A4 
sheet of paper is 1 page, as 
far as Text87 is concerned, 
but 2 in the context of the 
newsletter, you may have to 
create, say, 4 frames to take 
separate headers and 
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footers for each of the 2 AS 
pages on one side of a sheet 
of paper. 


Don't hesitate to use the 
Print Preview, frequently. It is 
quick to produce a display of 
the "cameo" pages (PC 
programs tend to be very 
slow at displaying previews). 
Whilst you cannot read any 
of the text, you can certainly 
see whether or not the 
general form of it is going to 
look sensible when printed. 


If you want to be a bit 
fancier, draw some lines to 
separate the columns. 
Text87 doesn't have a line- 
draw function -- particularly 
not in the vertical direction -- 
but what about using the 
underline style with the 
Space Bar and printing lines 
across the page in Portrait 
mode? This could be done 
before or after printing the 
text. For a regular 
publication, a master 
document with the necessary 
divider lines on it could be 
saved and re-used as 
required. A master could be 
set up for the column 
settings, too, Although Plus-4 
lets you have — several 


Layouts in a document, you 
can't do that in this case, 
because the page size & 
orientation have to remain 
the same. You must reset 
the printer after the first run- 
through of the paper; it will 
have to be set to Portrait to 
print the lines, then 
Landscape to print the text, 
or vice versa. 


The preceding point brings 
up another, in connection 
with founts. Text87 does not 
itself have both portrait and 
landscape founts and your 
printer may not have the 
same range in landscape 
orientation that it has in 
portrait. You might have to 
settle for a choice of just 2 
founts in landscape mode. 


A way round this particular 
problem is to use the 
Fountext88 graphics printer- 
driver, which sends text to a 
printer as a graphics image, 
making it irrelevant what 
founts the printer has or 
doesnt have. The founts 
printed this way are by no 
means as smooth as those 
that are built-into printers 
such as the Hewlett-Packard 
DeskJet or LaserJet, though. 
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markers are preserved, but the actual tab 
positions change if the Tabs set on the 
current Ruler differ from those set in the 
_DOC file. The _T87 file selected was 
about three years old, anda mere 14 KBin 
size; this seemed less than a serious test, 
so four other _187 files of roughly the same 
size each were appended to the first one, 
using the F3-File-Merge-Ascii command. 
Again, the earlier version gave a problem 
here, but that was promptly sorted out and 
all went well, and speedily, with the current 
version. 


Ascii loading 


The file format for _T87 and _T91 (the 
new type) files is not the same, and this is 
why the test files had to be treated as 
being Ascii. Formatting information and 
text attributes are preserved with files 
LOADed as _T87 files (but not with those 
subsequently MERGEd as Ascii files). A 
SuperBasic boot file was loaded with F3- 
File-Import-Ascii also; the only things to 
note here are that the default Ruler set- 
ting is for full justification, which is un- 
likely to be suitable for program files (or 
indeed for many users’ text files) and the 
margins need to be set wide enough for 
the maximum line length. 

Some users will be interested in load- 
ing Perfection files. The two files that 
were checked loaded without hesitation, 
and the text format was basically correct. 
It was necessary to increase the Room 
(editing space) value to load a large file. 
The main market for T87, as for Perfec- 
tion, is those users who are still clinging to 
Quill. You may well have to make layout, 
ruler and fount changes before, and pos- 
sibly after, loading any ‘alien’ file, and 
there is no great problem in doing so, but 
it may take a fair amount of time, as it 
does with many other programs. There 
are Normal and Paragraph options for 
loading non-T87 files - the equivalent of 
Quill’s By Line and By Paragraph op- 
tions. 

Memory-management is something 
no program seems to get fully right, 
from the user’s point of view, but the 
Qdos operating system is not exactly 
helpful to the application programmer 
in this respect. Many users will be 
aware of the way Quill solves the 
problem by grabbing all the memory it 
can find. You know where you stand 
with Quill! T87 has a more difficult 
task; apart from the fact that your 
documents may vary greatly in size, 
you may wish to load several docu- 
ments during the same session, and 
there is no way the program can an- 
ticipate the total memory requirementfor all 
you wish to do. The Room command allows 
you to set the working space in memory, to 
some extent. As my first actions while doing 
this review came up against shortage of 
memory, it would have been nice to find an 
index in the instructions, with ‘Memory’ or 
‘Room’ listed. 
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All in memory 


The on-screen help tells you that the 
Room you allocate is expansion space for 
the next file to be loaded, and will be 
added to that taken by any files already 
loaded. The current program version has 
additional information on the screen con- 
cerning this function, and - as mentioned 
above - the commands which are con- 
nected to the Room function now work 
appreciably better. The instructions are 
to be modified also, to give more guid- 
ance to the user, and to incorporate an 
index. One thing to bear in mind is that the 
whole of a file is in memory, rather than 
part of it being on disk as can happen with 
long Quill documents, and this means 
faster operation. 

It has been a plus-point of T87 for some 
time that certain printers can be used in 
their native modes, rather than being 
treated as simple, Epson-compatible 
types. The illustrations for my articles are 
printed on an Epson GQ-5000 laser 
printer. While using even only basic Cou- 
rier 10-pitch on a laser printer produces a 
big improvement in perceived print qual- 
ity over most dot-matrix printout, the dif- 
ference becomes much more marked 
when you can use other founts and sizes 
which may be built into the laser. In the 
case of the GQ, the supplied printer driver 
(not part of the basic T87 package) uses 
the scalable Times and Helvetica founts, 
albeit only at certain sizes. The range of 
sizes is good, from 6 to 72 points, in steps 
of 2 to up to 14-point. If your printer 
supports printing in landscape mode, Plus- 
4 allows you to do this. The Layout must 
have suitably-wide margins; even with 
standard one-inch margins, you can printa 
spreadsheet with 116 12-pitch characters 
across landscape A4 paper. As with the 
extended Layout function, this brings you 
closer to having DTP capability. 


Talking printers 


Getting your particular printer to co-oper- 
ate with a program has always been a 
major problem for users, and T87 attempts 
to ease this by giving a choice of 32 printer 
drivers in the basic package, plus other 
special ones available for 24-pin DMP 
printers, the HP DeskJet (covering LaserJet 
Il emulation also), and Epson lasers, at 
extra cost. Itis likely that most users will be 
able to find a suitable driver from those 
offered, and there is no need to get in- 
volved in any configuration procedure. 
Indeed, no provision is now made for any 
custom-tailoring, but anyone with special 
requirements can contact Software87 and 
ask if these can be met (don’t assume 
changes will be done for free, though). 

A feature that has gone missing is the 
visible fount/size code. You still have an 
indicator to show you what the current 


selection is, but the codes are no longer 
seen in the text. Printing codes in general 
are something which can easily arouse 
strong arguments; my own preference is 
to have as many codes as possible either 
always visible within the text or, prefer- 
ably, displayable only when the user wants 
them, but the average user is more likely 
to want them hidden all the time. 

Criticisms? They were relatively minor 
with the earlier versions and have almost 
all been dealt with by the E3 version. It 
has never been of interest to me to know 
what line within a document the cursor is 
on, but this is what is shown on the status 
line, initially; to satisfy this complaint, an 
option has been added to set the default 
line numbering to within-page or within- 
document. The lack of automatic saving 
and reloading of the supplementary word 
list for the spelling checker is an irritation, 
but not a great one. The handling of 
memory might confuse the user, but it 
may be partly caused by the unhelpful 
way Qdos manages memory, and the 
latest program version certainly makes it 
much less likely most users will need to 
change the Room value. 


Layouts and frames 


The setting-up of Layouts and Frames 
cannot be called intuitive operations; you 
really need to read the instructions sev- 
eral times and look at the samples pro- 
vided. Maybe the process cannot be sim- 
plified much, but it took me longer than it 
should have to get the hang of it. It 
would be useful to have some more 
flexibility in certain commands; on the 
other hand, a few less keypresses 
would be appreciated. There is, as 
yet, no advance on the previous 
graphics-import function (which was 
anyway provided by an add-on pro- 
gram), so that full DTP functionality is 
still some way off; the addition of the 
necessary features is a large job, and 
would justify a considerable price in- 
crease, whilst being of interest to only 
a limited section of the QL community. 
The comments made above about the 
on-screen representation of typestyles 
and line spacing should be viewed in 
comparison with what other QL pro- 
grams offer; as has been the case 
from the start, T87 has to be put into 
the DTP category in this one respect. 

Plus-4 is a big step forward from 
previous versions. You still have to 
work at using some functions, but the 
menu structure has been improved and 
more help is given now, both on-screen 
and in the instructions. The flexibility 
of document layout is much-increased, 
and the print preview takes the pro- 
gram into a more professional area. It 
is fast, with no operational problems 
apparent. Made for serious scribes 
who care what the printed output looks 
like. Good value for money. 
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OFTWARE FILE 
Cricket 
Secretary 


Wotzat? It’s John Shaw - trying to keep his 
speed down to the pace of a game of cricket! 


INFORMATION 

Program: Cricket Secretary. 
A suite of programs to enable 
the Secretary of a cricket club to 
maintain the batting and 
bowling averages of his club. 
Author: CB Storey. 
Supplier: Dilwyn Jones 
Computing 

41 Bros Emrys 

Tal y Bont 

Bangor 

Gwynnedd 

Price: £12.00 

Mdv, 3.5 in or 5.25 in disks. 
Works on an unexpanded Q.L. 


H 


owzat! Here is a program 
especially designed for 
cricket lovers. To those 


devotees of the most English of 
games, watching is only half of 
the pleasure. The other half comes 
from writing down the scores, 
working out the batting Averages 
and then discussing them at length 


over a pint in the Local. 

CB Storey has now developed 
the perfect program that does all 
the hard work for you. This, of 
course, leaves much more time for 
the discussion afterwards. Here 
we have a suite of programs , 
suitable for use by a cricket Secre- 
tary or enthusiast alike. All the 
statistics are available once the 
data has been entered: 


Batting Averages 
Bowling Averages 
Best Bowling 
Dismissal Averages 


The program is supplied with 
an eight-page Manual that leads 
you through every aspect of the 
inputting and dataretrieval system. 
I didn’t find that it flowed as well 
as some I have read, and I rec- 
ommend that buyers read it 
through thoroughly a few times 
before entering lots of data. It is 
not totally error-trapped, and a 
couple of times I crashed the pro- 
gram before I could save it on toa 
disk. This was due to a little ambi- 
guity in the instructions. 

The instructions start by telling 
you how to create the two disks 
required for the program to work. 
In fact, three are needed, one be- 
ing a blank formatted disk to put 
the compulsory backup on. If you 
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try and get away without one, the 
first crash occurs. Once you have 
followed the set-up instructions, 
you are left with a master disk 
containing all the files needed to 
run the main part of the program, 
and a Data disk that will hold your 
scores and averages. 

On running the program, you 
are asked which drives your mas- 
ter and data disks are on. Unfortu- 
nately, you have to do this every 
time you run the program. I found 
this a little tedious, and would 
have preferred to have had this 
configured permanently. 

Then the Suite Menu appears: 


1. Run Cricket Secretary 
2. Run Printa 

3. Run Toolkit 

4. Quit 


You make your choice by 
pressing the appropriate number. 
You will then be asked for the 
suffix of the files you wish to 
process. On the first occasion this 
is _0. This uses a skeleton pro- 
gram that forms the basis of future 
files. When you come to save 
them, you add a suitable suffix 
such as_som92 (Somerset 1992). 
You will eventually build up data 
files on the disk for every team or 
series you are collating. 

That done, you are confronted 
by a menu offering the following 
choices: Input Batting, Input 
Bowling, Examine Batting Aver- 
ages; Examine Bowling Aver- 
ages; Examine Best Bowling; 
Examine Dismissal Analysis; 
Load new file/backup/return to 
menu. 

Input Batting 

On selecting this, you are first 
asked for the name of the crick- 
eter. It is important that this is 
done in the correct format, that is: 
Shaw JR. (Neither SHAW JR nor 
JR Shaw. You have been warned!) 


You then enter the number of 
runs scored. This is followed by 
an alphabetical input representing 
how the player was dismissed. A 
table of entries is provided to as- 
sist with this. 

This sequence then repeats itself 
until you have entered all the 
batter’s details. 

Input Bowling 

The principles are the same as 
for the Batting input. The number 
of Overs bowled is the first data to 
be entered. This is followed by the 
number of Maidens bowled, the 
number of Runs and finally the 
number of Wickets taken. The 
sequence then repeats itself. 

Batting Averages 

The batting data is computed to 
two decimal places and displayed 
in order of Average, the highest 
first. 

Bowling Averages 

These are computed to the same 
standard as the batting averages. 

Best Bowling 

This is a sub-set of the Bowling 
Average table, and comprises the 
Name, Runs per over, Balls per 
wicket and best Bowling. 

Dismissal Analysis 

This will show a table display- 
ing how many times each batter 
has been dismissed and the method 
of dismissal. 


Load New File 

This is the compulsory Backup 
point. If you try to ignore the 
warning, you will crash and your 
data will be lost. Make sure you 
have a spare blank disk ready. 

Printa enables you to print out 
hard copies of the data you have 
just compiled. You are given the 
option of installing a new printer 
driver if you wish. The Toolkit 
allows you to modify the database 
should you accidentally put in 
wrong detail. The author warns 
that you should take great care 
when using this facility. I agree! 

This is a good and extensive 
program that, however, needs to 
be handled alittle carefully in order 
to avoid problems. I offer you 
these few tips: 


Have three blank disks ready at 
the beginning. 

Read the Manual a few times 
before you start using the pro- 
gram. 

Practice with a small amount of 
input in order to become familiar 
with the program before you enter 
all your scores. 

Remember the way it requires 
you to enter the names, ie Brown 
GM. 

Always keep a straight bat! 


CRIEKET SEE SUITE MeN D 


Copyright 80 6 Storey, 1992 


1. RUN CRICKET SECRETARY 


2. RUM PRIHTA 


3. RUN TOOLKIT 


4. QUIT 


¥4% Press the number you require 4+ 


“CLUB: 


[FRANCE [NORWAY __ - ENGLAND 


QL Contact France. Contact: Jean- 
Louis Dianoux, 38-40 Rue 


"BELG 75018 Paris, France. 


Club Sinclair BruQsL (Belgium) 


Contact: Jaques Tasset, Aarlenstraat 
104, 1040 Brussels, Belgium 


International QL Conference bul- 
letin board system (Swedish and 
English). Contact: Michael 
Cronsten, System Operator, Jamten- 
TCL, S Soere 1073, 83030 Lit, Swe- 
den. 


New England Sinclair QL User 
Group (USA) Membership Secre- 
tary: Sherm Waterman, PO Box 
8763, Boston, MA 021148763, USA. 
Magazine: NESQLUG News. Editor: 
Peter Hale, 195 Central Ave., Chel- 
sea, MA 02150, USA. 


Norwegian All Sinclair Association 
(NASA) Contact: P Monstad, NASA, 
N-5580 Oelen, Norway. Magazine: 
Sinclair Magazine. 


ITALY 


Qitaly Club Chairman: Roberto 
Orlandi, Via Brescia 26, 25039 
Travagliato (BS), Italy. Tel. (local) +39 
30 6863311. Magazine: Qitaly Maga- 
zine. Editor: Dr Eros Forenzi, Via 
Valeriana 44, 23010 Berbenno (SO), 
Italy. Tel. (local) +39 342 492323. 


TURKEY 


QL Qlub (Turkey). Contact: Bulent 
Artuz, Prof. Sitesi B/1 D/5, Etiler 
80600, Istanbul, Turkey. 


AUSTRIA 


DER Computer Club. Contact: Peter 
Postl, Stiegerg 5, 1150 Wien, Austria 


Quanta (UK) Membership Secre- 
tary, Bill Newell, 213 Manor Road, 
Benfleet, Essex SS7 4JD. Maga- 
zine: Quanta. Editor: Bill Fuggle, 
20 Widnes Avenue, Selly Oak, 
Birmingham B29 6QE. 

Bristol sub-group: Roy Brereton, 
94 Teignmouth Rd, Clevedon, 
Avon BS21 6DR. 

Essex sub-group: Dave Walker, 22 
Kempton’s Mead, Potters Bar, 
Herts EM6 3HZ. 

London sub-group: Jeremy Davis, 
6 Elmcroft Crescent, Harrow, 
Middlesex HA2 6HN. 

Northern Ireland: Billy 
Turkington, Fairyhill, Rostrevor, 
Newry, Co., Down BT34 3BB. 
Mid-Southern sub-group: Geoff 
Fish, 44 Billing Avenue, Wokingham, 
Berks RG11 4JE. 

QL User Group (West Midlands): 
Mike Bedford-White, 16 Westfield 
Road, Acocks Green, Birmingham 
B27 7TL. 

QL MUG: 3 Barnard Road, 
Birkenhead, L43 1TT. 


Solent Sub Group: Graham Evans, 
32 Reeves Way, Lowford, 
Bursledon, Southampton. Tel 0703 
403350 


SCOTLAND 


Scottish OL Users Group Contact: 
Alan Pemberton,65 Lingerwood Rd., 
Newtongrange, Midlothian EH22 
4Q0. Newsletter. 


HOLLAND 


Sin_QL_Air (Netherlands) Mem- 
bership Secretary: Bob Visser, 
Snelrewaard 6,2904SN Capelle,a/ 
d Jjssel, Netherlands. Magazine: 
Quasar. Editor: C H M Biemans, 
Elzenstraat 5, 5461 CL Veghel, 
Netherlands. 


GERMANY 


Sinclair QL User Club eV (Ger- 
many) Foreign Contact: Franz 
Herrmann, Talstrasse 21,d-W5460 
Ochenfels, West Germany. Maga- 
zine: Quasar. 


Qliper Editor: Marcos Cruz, 
Acacias 44, (Monteclaro),E- 
28223,Pozuelode Alarcon. Spain. 
Magazine: Qliper. 


ARGHIVE YOUR @ 


GOLLECGTIOINI 


Now you can keep your Sinclair QL 
World magazines safe and clean. No 
more dog-eared covers or missing 
copies . . . You can protect your 
magazines in this high qual 
specially-created binder. This Sinclair 
QL World binder will comfortably hold 
a complete year’s issues of your. 
favourite Sinclair magazine. It is a high 


ly, 


quality product, British-made and , 
comes with full binding instructions. It is 
manufactured in a rich, deep blue with | 
genuine gold blocked lettering. 

Enhance your Sinclair QL World 
Magazine collection now for only 

£6.95 (inc.P&P!) Send for one today! 
The QL World binders also make an 
ideal gift for other Sinclair users too! 


| TO: QL WORLD, THE BLUE BARN, WOOTTON, WOODSTOCK, OXON. OX7 1HA| a | 


I Please send me [_] QL World binders — | enclose £6.95 for each binder including VAT. postage & packing. sf I 
I Readers outside the UK and Eire please add £1.95 for surface overseas mail. ig: ae eI 
| Please make cheques payable to ARCWID LTD. ere | 
JACCESSLIvisALlaccount;| | | Expiry date: ccsccceee I 
I I 
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THE srUTIT 
NEW 
USER GUIDE 


KEYWORD INDEX 


This month in the Keyword Index, Mike Lloyd 
Ld starts with INPUT$(#chan, length) and fin- 
ishes with the command without which none 
of this would be possible: SuperBasic LRUN. 


INPUT$(#chan, length) 
[Turbo Toolkit] 


INPUT FUNCTION 
#chan(Optional) A valid channel linked to an input device 
length The number of characters to be returned 


INPUTS is an unusual little function that waits for a precise number of input characters before allowing 
processing to continue. If the input channel is a screen console, no cursor is displayed to prompt for input. 
INPUT$ is of most value extracting set lengths of characters from files and.network channels. The default 
channel is #1, but keyboard input is obtained by specifying #0. 


INSTR 
TEXT OPERATOR 
Example: IF ‘z" INSTR surname$ THEN... 


© Most operators are represented by symbols, but a suitable symbol was presumably unavailable 
when INSTR was devised. Other languages have implemented INSTR as a function with the format: x = 
INSTR(“w", “hello world”) but SuperBasic obviously had to be different. The results, however, are the same. 
Both operands are string variables or constants. If the first is found within the second then the location is 
returned. If no match is found then a zero is returned. “W” INSTR “Hello World” returns 7 because “W’” is the 
seventh character of the string being searched. The search is not case-sensitive. 


INT(number) 
MATHEMATICAL FUNCTION 
number A floating point value 


The INT function truncates a floating point value at the decimal point, converting it to an integer. 


INTEGER$ (number) 
[Turbo Toolkit] 
BYTE CONVERSION FUNCTION 
number An integer within the range -32768 and 32767 


The INTEGER$ function returns a string of exactly two Ascii characters that represent a 16-bit SuperBasic 
integer. This is usually superior to allowing SuperBasic to convert integers to floating point format. The Turbo 
Toolkit STRING% function converts the string back to an integer. 

JOBS #chan 
[Super Toolkit Il] 
JOBS(id or name) 


[Super Toolkit Il] 
TASK MANAGEMENT 
* chan(Optional) A valid channel 
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KEYROW(row) 
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The JOBS command simply lists all running jobs to the appropriate channel. The default is #1. When the QL is 
turned on the only task running is SuperBasic. The JOBS function is used with related functions to point to and 
operate on jobs in the Qdos job list; operations that lie outside the scope of this SuperBasic guide. 


LOW-LEVEL KEYBOARD READER 
row An integer between 0 and 7 


There are 65 keys on the standard QL keyboard; each is identified to Qdos by a reference number. The two 
Shift keys share one reference number, which means that all of the keys can be represented on an eight-by- 
eight grid. The KEYROW function interrogates the grid to discover which, if any, keys are being pressed. 
There are three essential differences between KEYROW and the apparently similar INKEY$. KEYROW 
returns its own code reference, not an Ascii character: it can detect many keys pressed at once; and it reads 
the keyboard directly, not through a channel. These differences are advantageous in games, compiled 
programs that do not have an input channel, and when writing intelligent input control routines. 

KEYROW works by accepting a row number (from 0 to 7) as its parameter. It instantly returns a byte value that 
indicates which, if any, keys on the row were being pressed. Eight calls would be necessary to poll the entire 
keyboard, but in many instances a single row contains all the likely keys. The four cursor keys, Space, Enter 
and Escape, for example, are all on KEYROW(1). 


KEYROW’S KEYBOARD MATRIX 
Each row in the matrix is read by a single KEYROW call using the parameter identified in the shaded column 
on the left. The value returned will be zero if no key in the row is being pressed, or the sum of the column 
headings of keys being pressed. For instance, if the Q and the T keys are pressed simultaneously, 
KEYROW(6) will return 72 (that is, 64+8). Note that at least some editions of the Sinclair User Guide contain a 
number of misprints in the KEYROW matrix, 


The following routine will be of value when looking up a particular KEYROW value for a single printable keypress: 


100 DEFine PROCedure KEYTEST 
110  REPeat loop 


120 char$ = INKEY$(-1) 

130 FOR row =0 TO7 

140 col = KEYROW(row) 

150 IF col>0 

160 PRINT char$;" = ROW “: row; “, COL “col 
170 ENDIF 

180 END FOR row 


190 END REPeat 


Each column value in the KEYROW matrix represents a single set bit, so the best way of interpreting the result 
of a KEYROW call is to use the bitwise operator &&. Something like the following routine will be found at the 
heart of a great many arcade games. It finds out which of the cursor keys is being pressed and moves a 
graphics block accordingly: 


100 WINDOW 512, 256, 0, 0: PAPER 0: CLS 
110 Ypos = 150: Xpos = 256 

120 REPeat Loop 

130 BLOCK 4,4, Xpos,Ypos, 4 

140 shift = KEYROW(1) 

150 IF shift && 2: xpos = xpos - 2 
160 IF shift && 4: ypos = ypos - 2 
170 IF shift && 16: xpos = xpos + 2 
180 IF shift && 128: ypos = ypos + 2 
190 IF shift &8& 8: STOP 

200 END REPeat loop 
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LBYTES filename, 
base_address 


LEN(string$) 
LEN(number) 


LET <expression> 


LINE #chan, x1, y1 

LINE #chan, x1, y1 TO x2, y2 TO... 
LINE #chan, TO x3, y3 

LINE_R #chan, x1, y1 

LINE_R #chan, x1, y1 TO x2, y2 
LINE_R #chan, TO x3, y3 


LIST #chan 
LIST #chan, 100 TO 200 
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Note: Trying to move the block beyond the edge of the screen will cause an error. 


KEYROW can return some strange values if the keys forming three corners of an imaginary rectangle on the 
grid are pressed. The result will suggest that the key at the fourth corner is also being pressed. Shift, Ctrl and 
Alt are exceptions to this rule. 


MEMORY MANAGEMENT COMMAND 
filename The name of a file containing binary data, normally a program 
base_address The lowest location in RAM where the data will be stored 


LBYTES is short for ‘load bytes’. The bytes in question might be a screen image, some data or, more usually, 
a program. The command needs to know where to look for the bytes and where in ram to begin loading them. 
As Qdos rarely misses any opportunity to rearrange the contents of ram, care must be taken to ensure that 
LBYTES does not overwrite critical areas of memory. Given an amount of space to reserve, the RESPR 
function will return the start address of a reserved area of memory sufficient for the task. Thus, a program 
might be activated like this: 


100 base = RESPR(6000) 
110 LBYTES flp1_arcade, base 
120 CALL base 


About the only reliable absolute address on the QL (and even this is open to some change) is the start of the 
screen map at location 131072. Its size is always 32K, no matter what mode the screen is in. 

Files that contain binary data have to be saved using the SBYTES command with the appropriate parameters. 
Some database designers prefer to store data ‘in the raw’ rather than use SuperBasic arrays. Sorting data 
becomes a very fast and relatively simple matter of moving blocks of memory around. Text data can be 
compressed (to two characters per byte, for instance) and searched for at high speed with the appropriate 
procedures. Turbo Toolkit is an essential purchase for SuperBasic programmers attempting this sort of data 
manipulation. 


STRING FUNCTION 
string$ A string variable 
number A floating point or integer value 


This function answers the eternal question ‘How long is a piece of string?’. A string in SuperBasic is zero, one 
or more Ascii characters. The LEN function takes the string as its argument and returns the number of 
characters it contains. Null, or empty, strings will return the value 0 (or False if used in logical expressions). 
Although elements of string arrays occupy a fixed number of bytes, LEN returns the exact number of charac- 
ters contained in a given element. SuperBasic’s powerful coercion facility means that LEN works equally well 
on numeric values, which is of particular value when formatting columns of numbers. When coercing numbers 
into strings, LEN reflects the length of the scientific format of very large and very small numbers, not the 
number of digits. 


VARIABLE ASSIGNMENT 
<expression> A variable assignment of the form X = Y + 7 or Y$ = “Hello” 


LET is a wholly redundant keyword that was presumably included in SuperBasic for compatibility with earlier 
dialects. Its job is to precede variable assignments to make absolutely clear what is happening within an 
assignment statement. However, the following lines are identical in effect: 


LET X= 25 
x= 25 

GRAPHICS COMMAND 
#chan (Optional) A screen channel 
x1, y1, ete. Graphics co-ordinates 


The LINE and LINE_R commands move the graphics cursor. The _R suffix indicates that the movement is to 
be relative to the current location of the graphics cursor rather than relative to the graphics origin. The 
parameters taken by LINE and LINE_R are pairs of comma-separated values representing horizontal and 
vertical co-ordinates in the QL's graphics co-ordinate system. The TO keyword between co-ordinate pairs inks 
the path between the current and new cursor positions. If the co-ordinate pairs are separated by commas the 
cursor simply moves, without leaving an ink trail, to the location of the final pair of co-ordinates. Odd numbers 
of co-ordinates cause a ‘bad parameter’ message. 
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LIST #chan, 100 TO 200, 300 


TO 350 
LIST #chan, 10, 50, 30 PROGRAM COMMAND € 
LIST #chan, x TO y #chan (Optional) An output channel 

x TOy Integer values representing line numbers 


The LIST command without parameters lists the currently loaded SuperBasic program to Window #2. The 
listing can be directed to a printer, another window, the network or a file by including a channel reference. 
Listings can be limited to one or more groups of lines by including ranges in the form 100 TO 200. A number 
of single lines can be listed by including a comma-separated list. Note that the Super Toolkit || ED command 
both lists program lines and allows you to edit them within the chosen window. 


LIST_TASKS #chan 


eS rn MEMORY COMMAND 
#chan (Optional) An output channel 


This command lists all tasks currently loaded into the QL’s memory. SuperBasic is represented as task 0,0. It 
is the equivalent of Super Toolkit II’s JOBS command but has the added advantages of no header, the 
inclusion of each task’s name and the use of a comma-separated format. 


LN(pos_value) MATHEMATICAL FUNCTION 
pos_value A value greater than zero 


The LN function returns the natural logarithm of any positive value passed to it. The irrational number e has a LN 
value of one. 


LOAD filename PROGRAM COMMAND 
filename The drive and name of a file containing a SuperBasic program 


The LOAD command fetches a SuperBasic program from the given filename and installs it in the QL’s 
memory, removing any existing program that might already be there. Although LOAD can be used within 
programs, LRUN is usually preferable because the new program will be executed automatically. The QL is 
particularly slow at loading SuperBasic programs because they are stored as plain text on file and need to be 
tokenised when moved into memory. There is at least one utility on the market that makes program loading 
very much faster. 


LOCAL p1, p2, p3... 
INTERPRETER DIRECTIVE 
pi, p2, p3 A comma-separated list of one or more variable names 


The addition of user-defined procedures and functions to SuperBasic led to the introduction of the LOCAL 
keyword. Its place is as the first executable statement after a DEFine command. The variable names included 
as parameters then have values that only exist within the definition. When the definition is left the local value 
is lost. If the variable name represented a value before the definition was called then that value is restored, 


100 X=12 
110 PRINT X: REMark result is 12 
120 PRINT Demo_Function : REMark result is 3 


130 PRINT X : REMark result is 12 & 
140 : 

150 DEFine FuNction Demo_Function 

160 LOCal X 

170 X=3 


180 RETurnX 
190 END DEFine 


MATHEMATICAL FUNCTION 
LOG1 O(pos_ value) pos_value A value greater than zero 


The LOG10 function returns the natural logarithm of any positive value passed to it. Ten has a LOG10 value of 
one and one has a LOG10 value of zero. 


PROGRAM COMMAND 

filename The drive and name of a file containing a SuperBasic program 

LRUN filename : j ¢ : a. 
The LRUN command fetches a SuperBasic program from the given filename, installs it in the QL’s memory 
and runs it. Any existing program that might already be there is removed. LRUN can be used within programs 
as a way of chaining a number of programs together. Be aware that the QL is particularly slow at loading 
SuperBasic programs because they are stored as plain text on file and need to be tokenised when moved into 
memory. 
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HARDWARE 


Care Electronics 

0923 672102 

Peripherals and accessories. 
Thor International 

010 4533 930305 

010 4533 937544 

Digital Precision 

081-527 5493 

Discs, interfaces, drives, keyboards, 
RAM expansions. 

EEC Ltd 

0753 888866 

QLs, peripherals, accessories 
Miracle Systems 

0904 423986 

Trump Card interface, modems, 
hard disc drive. 

Strong Computer Systems 
0267 231246. 

S.P.E.M 

Via Aosta 16, 10154 Torino, Italy. 
+39 11 857924 Fax +39 11280009 
QL disk interfaces, ram, eprom 
holders. 

TF Services 

071 724 9053 

Repairs, spares, peripherals. 

TK Computerware 

0303 812801 

Peripherals. 


) le Ne  Feehe] 
SERVICES 


Adman Services 

0952 255895 

Joe Atkinson 

36 Ranelagh Road, London W5 5RuJ 
Roms, mdvs and all spares. 
Suredata 

081-902 5218 

Repairs. 


QL World 

(reader services) 
Subscriptions and back issues 
0869 83677 

Quanta 

User Group, support. 

Hon. secretary, Phil Borman. 
0933 460690 


y Lee Pepe] 
SOFTWARE 


Athene Consultants 

0705 511439 

ARK Distribution 

0983 79496 

Archivist, Master Spy and other business 
and utility software. 

Call Us What You Like 

55 Greenan, Shaws Road, Belfast BT 11 
8LX. No telephone. Superspy. 

Care Electronics 

0923 672102 

Tony Tebby software. Miracle hardware, 
peripherals, utilities. 

CGH Services 

0559384 574 

Adventures. QLAF, DIY Toolkit. 
Compware 

0270 582301 

Task Swopper, Mega Toolbox, Expert, 
System Shell, Speedscreen and others. 
COWO Electronic 

010 41 45 211478 (Switzerland) 

QTop, Atari QL emulator, Thor support 
Digital Precision 

081-527 5493 

Turbo Basic compiler, Desktop 
Publisher, Editor, Eye-Q Graphics. Sprite 
generator, Super Forth, Better Basic, 
Professional and Super Astrologer, 
Media Manager, Supercharge, 
Blocklands, Droidzone, Aracadia, 
Reversi, Backgammon, Master Bridge 
Tutor, C-M Emulator, C compiler, 
Lightning speed enhancer, Perfection. 
DJW Software 

0256 881701 

Homebanker 


Dilwyn Jones Computing 

0248 354023 

Home Budget, Vision Mixer, QL 
Genealogist, Textidy, Spellbound and 
others. 

ImaQLate Software 

42 Albion Street, Broadstairs, Kent CT10 
1NE. 

Biograph. 

Jochen Merz Software 

010 49 203501274 

QL/Atari Emulators, utility and games 
software. 

Lear Data Systems 

6 Southview Green, Bentley 

Ipswich, Suffolk IP9 2DR 

Qtris 

Liberation Software 

081 546 7795 

Basic compiler (QLib) and utilities. 
Progs (Van Auwera) 

010 32 16 48 8952 (Belgium) 

The Painter, The Clipart, Data-Design, 
Qractal. 

QFILE 

Apartado 2110 p-1103 Lisboa Codex, 
MS-Link and Discopy. Portugal. 

QL Supersoft 

0256 475992 

Spell, Numbers, Superdraw. 
Qubbesoft PD 

38 Brunwin Road, Rayne, Braintree, 
Essex CM7 5BU 

Public domain software. 

SD Microsystems 

0462 422897 

Business software including General 
Ledger. Small Traders’ Pack/Invoicer 
and Stock Accounting. 

Software 87 

33 Savernake Road, London NW3 2JU 
Text 87 and updates. 

Talent Software 

0303 813883 

Utilities, games. 

TK Computerware 

0303 812801 

Add-ons, spares, software. 

WD Software 

0534 81392 


Practical 
Astronomy With 
Your Calculator 
Peter Duffet- 
Smith 
£11.95 
Astronomy With 
Your Personal 
Computer 
Peter Duffet- 
Smith 
£15.95 
Cambridge 
University Press 
Currently in 
print 

QL Specific: No 


ractical astronomy with 

your calculator is a cor- 

nucopia of algorithms 

for solving the often 
nightmarish calculations in- 
volved in astronomical math- 
ematics. Do not be misled by 
the title: included is everything 
from relatively straightfor- 
ward data and _ time 
calculations and conversions 
between co-ordinate systems 
to calculating the effects of 
atmospheric refraction, and the 
positions of the sun, moon and 
planets with a degree of 
accuracy which will satisfy all 
but the most exacting require- 
ments. Times of the rising and 
setting of sun and moon, for 
example, can be found to 
within about a minute. 

The mathematics used is not 
only eminently suitable for a 
personal computer but, for re- 
peated calculations, makes one 
almost essential. Each section 
has not only a clear explana- 
tion of what is being done but 
at least one worked example. 

The related volume As- 
tronomy with your personal com- 
puter covers for the most part 
the same ground, thoughalgo- 
rithms are given ina language 
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Cornucopia of 
Algorithms 


not unlike microsoft basic in- 
stead of step-by-step calcula- 
tion. This translates easily to 
the QL’s SuperBasic, the more 
so as the superbasic functions 
RAD, DEG, ASIN and ACOS 
can replace the more rounda- 
bout methods which Duffett- 
Smith uses in order to maxim- 
ise the compatibility between 
dialects. In addition his 
modular approach lends well 
to the building of a library of 
superbasic procedures and 
functions which can be merged 
as appropriate for particular 
applications. 

A number of the algorithms 
— particularly those which cal- 
culate the positions of the sun, 
moon and planets — differ sub- 
stantially from the companion 
volume in being more accurate 
still, albeit at the inevitable 
expense of more typing-in and 
less speed in execution. (Find- 
ing the instantaneous position 
of the moon, for example re- 
quires 99 SIN and 32 COS cal- 
culations, even before the re- 
sults have been worked into a 
useful format.) 

One intriguing extra section 
provides a method of deriving 
acomet’s orbital elements from 
visual observations: these can 
then be used to predict its fu- 
ture path. 

A problem with SuperBasic 
which both of these books 
highlight is that of the numeri- 
cal accuracy of constants. It will 
often be necessary to use 
something like e=’23.441893’ 
(with quotes) as otherwise 
SuperBasic will store any 
eighth and ninth digits inter- 
nally only to lose them again if 
the line is subsequently edited 
or the program saved and re- 
loaded. Entering constants as 
strings (which the system co- 
erces to floating-point numbers 
when they are allocated) en- 


sures that all significant figures stay where they are put, which 
makes a worthwhile difference with calculations such as these. 

Having said that, even this reviewer's humble JS machine 
produced results which generally were closer to published 
predictions than the examples provided by the author, which 
were evidently run on an IBM micro. There is, however, much 
scope here for putting to practical use the accelerated maths 
routines of the Minerva rom or the Lightning maths extensions. 

Not only astronomers but anyone with an interest in simply 
playing with mathematics will find enough in these splendid 
books to keep them occupied for hours. 


A Valuable 
Reference Manual 


QL Advanced 
User Guide 
Adrian Dickens 
Adder Publishing 


£12.95 
Fairs, second- 
hand 

QOL Specific: Yes 


he QL Advanced User 

Guide is described, on 

its back cover as ‘the 

authoritative guide to the 
Sinclair QL System’. The descrip- 
tion finishes with the statement 
‘No programmer of the QL can 
consider not owning a copy of this 
invaluable reference manual’. I 
could find little in the book to 
cause me to disagree with these 
statements — it contains a great 
deal of very useful information. 
However the back cover also 
claims that the book ‘assumes no 
previous knowledge of operating 
systems or 68000 assembler’ — 
something I would hesitate to ac- 
cept. 

The Guide is made up largely of 

a comprehensive list of the func- 
tions that the QL’s inbuilt soft- 
ware, Qdos, provides for writers 
of machine code programs. These 
functions cover nearly any action 
that the QL may be seen doing, 
from saving data to printing to 
screen. By accessing them directly 
in machine code, full control can 


Hilary Snaden 


be gained over multitasking and 
similar internal functions of the 
machine. Each function is de- 
scribed, along with the methods 
used to invoke it, responses that 
may be given and parameters 
needed to be sent. 

This list is preceded by a short 
introduction to QL machine code, 
an overview of Qdos and a listing 
of an experimentor which allows 
Qdos functions to be tried from 
Basic. For those new to machine 
code the introduction is, to my 
mind at least, too short to be easily 
understood. I feel therefore that 
the book cannot claim to assume 
no knowledge of assembler — but 
for those who know at least the 
basics it is excellent. 

To demonstrate the uses of 
Qdos, the overview includes two 
assembler listings —one foraclock 
that displays the time permanently 
on screen and another for a set of 
rapidly reproducing, multitasking 
blobs that rush across the screen. 
Later listings show how to add 
procedures to Basic in machine 
code, how to control the QL’s 
under-used two screen facility and 
provide adevice driver for a paral- 
lel printer port. 

Following the list of Qdos 
functions, the QL device drivers 
are described, as well as internal 
formats for most information used 
by the operating system. Finally, 
the machine code interface to Ba- 
sic is examined. 
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This thorough description of the QL’s internal workings is comple- 
mented by twenty appendices that cover additional details of the 
machine, from its memory map to hardware expansion information. 
These are very useful in their own right — even including a circuit 
diagram for a printer interface to match the device driver documented 
earlier. The book is completed by a bibliography, a glossary and full 
index. Certainly no QL programmer ought to be without this guide. 


Andrew Toone 


Integration of 
Machine Code 
and Electronics 


Computer 
Interfacing — 
Connection to the 
Real World 
Martin Cripps 
Edward Arnold, 
Hodder and 
Stoughton Ltd 
£12.95 

Currently in print 
No 


Author: 
Publisher: 


Price: 
Available: 


QOL Specific: 


artin Cripps, as the 

reader of this book 

will be quick to find 

out, is not satisfied. 
He is not satisfied with the current 
state of computer interfacing. Asa 
Director of the Wolfson Micro- 
processor Unit and a Senior Lec- 
turer at Imperial College, he has 
greater qualification to comment 
on these matters than most. In 
Computer Interfacing he sets out 
to explain his reasons for being 
unimpressed with the way in which 
we link our computers to their 
environment and, more impor- 
tantly, ways in which those links 
can be improved. 

Computer Interfacing was writ- 
ten to support courses presented 
to final year undergraduate stu- 
dents in computing, and as such 
contains some fairly complex ex- 
planations involving for instance, 
integration, machine code and 
electronics. 

These are used as tools to de- 
scribe through the book the way in 
which information is taken from 
external stimuli into the computer 
and the corresponding path for 
data from the computer to influ- 
ence the real world. 

This description is well defined 
as stages in the flow of informa- 
tion. Sensors are discussed, then 
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the sampling of data so as to accu- 
rately record an input waveform. 
Signal conditioning is explained 
before methods of digital to ana- 
logue and analogue to digital con- 
version; following these, the book 
goes on to cover the digital links to 
and between computers before 
standard interfaces are discussed. 
The pathway from real world to 
computer and back again is com- 
pleted by a section on output 
transducers. 

After these sections, Cripps 
rounds his subject by covering en- 
vironmental constraints such as 
noise and power supply; micro- 
processor input-output; integrated 
interfaces (interfaces on a single 
chip); microprocessor architecture 
and design techniques, finishing 
with three design examples. The 
design examples perhaps best in- 
dicate the area in which Computer 
Interfacing is most useful. A gas- 
plasma display, automated green- 
house and a mobile robot are de- 
scribed in terms of the design de- 
cisions that would be taken to im- 
plementthem. By stepping through 
the stages of interfacing the real 
world to microprocessors, the book 
covers all of the details involved 
in implementing any small mi- 
croprocessor based system, from 
sophisticated engine management 
system to multiprocessing com- 
puter. 

The book is well thought out 
and written in an informal style 
that lightens this otherwise com- 
plex subject. For anyone inter- 
ested in computer hardware 
therefore, at a little under thirteen 
pounds it is a good value read — 
however, being written for fairly 
advanced students, some knowl- 
edge of the subjects involved is 
vital. 

Nigel Bates 


Drive Further than 
than Corner 


Developing Appli- 
cations on the 
Sinclair OL — Prac 
tical Ideas for 
Home and Business 
Use 

Mike Grace 
Sunshine Books 
(Scot Press), 1984 
£6.95 in 1985 

At fairs or second- 
hand 

QOL Specific: Yes 


Author: 


Publisher: 


Price: 
Available: 


you ve never be 

lieved that using a 

computer was meant 

to be fun as well 
asproductive then Mike Grace’s 
infectious enthusiasm for the QL 
and the bundled software might 
just change your mind. 

Grace stresses that it’s no good 
having powerful software unless 
you understand how that software 
works, and more importantly, how 
to apply it. Otherwise, it’s rather 
like using a Ferrari to drive around 
to the corner-shop for a pint of 
milk. 

Having said that, I must take the 
author to task for his misleading 
title. The book is concerned only 
with the Psion software and makes 
no reference to SuperBasic. Also, 
to judge by the examples he pro- 
vides for each of the Psion pack- 
ages, there isa very wide spectrum 
of meaning to his use of the word 
‘application’. 

Grace rightly points out that the 
strength of the Psion software is 
that you can use it straight away 
without the tedium of learning to 
program. He lists a whole range of 
possible uses for students, home- 
users, club secretaries, part-time 
businesses and self-employed 
people — in short, anyone with a 
QL, although he does caution that 
some things are better done on 
paper than on computer. The em- 
phatic message is: QL computing 
is for you! 

The book is divided into five 
sections covering a general intro- 
duction to the QL and Psion soft- 
ware and each of the bundled soft- 
ware packages Quill, Abacus, 
Archive, and Easel. Grace relies 
on the reader to cross-reference 
with the User Guide — the main 
weakness of his book — and he 


does not attempt a comprehensive 
description of all the commands. 
The longest section deals with 
Quill where the author encour- 
ages flair and creativity rather than 
viewing it merely as a kind of 
electronic typewriter. His account 
is comprehensive enough to enable 
the reader to use it effectively. 
However, the text needs to be read 
with the improvements of Version 
2.35 in mind. 

The section of Abacus is thorough 
and stimulating with interesting 
comments on the User Guide exam- 
ples together with several of his own 
applications. There is a useful table 
of the most commonly-encountered 
Abacus commands and functions, 
and an illustration of the use of sev- 
eral of the more esoteric ones such as 
ave( ) and if( ). However, Grace’s 
diary/schedule-planner applicationis 
agoodexampleofhis owninjunction 
that some things are better done on 
paper! 

The section of Archive covers 
most of the commands and func- 
tions, illustrated by some simple 
database applications. His advice 
on the opening and closing of Ar- 
chive files is misleading as data- 
base files are always at risk while 
they are open (as opposed to being 
looked at) even if they have been 
closed at some previous time. 
Grace does a particularly effective 
bit of soap-box shouting at the end 
of this section on how really good 
a computer the QL is. Unfortu- 
nately, the book starts to thin out a 
good deal from this point on. 

Grace, like most other people, 
raves over Easel and what he calls 
its incredible flexibility, but you'll 
need to study the User Guide in 
much more detail than for the other 
Psion packages to get the full 
benefit of this. 

At the end of the book, there is a 
glossary of both general and QL- 
specific jargon terms followed by 
a summary of chapter contents. 
Overall, there are few niggles with 
a book which is clearly laid out 
and written in a fresh and 
unpatronising style. For anyone 
who has not dared to think big 
with their Psion software or finds 
the User Guide too daunting, then 
I would recommend getting your 
hands on it. 

Nigel Bates 


i$ FTWARE FILE 


INFORMATION 

Program: MicroEmacs text editor, 
recompiled. 

Supplier: QubbeSoft and CGH public 
domain libraries 

Price and format: See individual 
suppliers 


icroEmacs must be one of the longest- 
running sagas in the history of comput 
ing. Its origins lie in the pre-home com 
puting days of the 1970s in the corridors 
of the Massachusetts Institute of Technology 
(MIT), where it was designed as a rough-and- 
ready text editor which could without too much 
difficulty be ported between different machines. 

To this end it was written in C, the idea being 
that any machine with the basic hardware re- 
quirements which was capable of compiling 
the source code should also be capable of 
running the program. 

The earliest versions were fairly basic, de- 
signed as a somewhat rudimentary aid to pro- 
gramming in C, but subsequent authors, most 
notably Daniel M Lawrence, together with a 
host of other programmers who have contrib- 
uted bits of code along the way, have made 
MicroEmacs into one of the most sophisticated 
text editors available anywhere. 

Most of the work in getting the program to 
work on the QL was done by Ken Norrie, who 
released acompilation with Lattice C of version 
3.9p of the source code. More latterly, anumber 
of minor bugs have been ironed out by Richard 
Kettlewell, and the code recompiled using the 
later and considerably improved C68 compiler. 
The result is a considerable increase in speed, 
though screen handling, the QL’s perpetual 
Achilles’ heel, is still somewhat slower than 
that of programs more painstakingly custom- 
ised for the QL. So flexible is MicroEmacs, 
however, that it is possible to speed up the 
screen by altering the vertical and horizontal 
and vertical scrolling rates - in effect, by 
configuring a ‘lazy screen’. 

For example: 


set $hscroll FALSE 


will ensure that only the cursor line is panned 
rather than the whole screen, while 


set $hjump 8 


forces it to pan eight characters at a time. The 
difference these make is dramatic. 
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C compiler. 


Slow screen 


However, while the problematic colour 
modes now work after a fashion, changing 
from the default values seems to have the 
unfortunate effect of considerably slowing 
screen handling. However, the startup con- 
figuration of white text on a black background 
with a green mode line will probably be ac- 
ceptable to most users, and it may well be that 
this minor bug will be fixed in future releases. 

An advantage which MicroEmacs shares 
with the best QL software is that it multitasks 
from Basic with neither problems nor any need 
for fiddly extensions to SuperBasic. Indeed, 
since like Digital Precision’s Editor it has no 
inbuilt directory facilities, multitasking via 
EXEC or EX is essential to make available 
SuperBasic’s DIR command. The program code 
is fairly lengthy, but at some 98K it is only 
marginally longer than Editor, but with more to 
offer as a text editor; however, it should perhaps 
be stressed that MicroEmacs is not a 
wordprocessor. Most importantly, it has no 
facilities for driving printers. 

It does have a number of functions rarely 
found in the most sophisticated of 
wordprocessors, and it is a relatively straight- 
forward matter to insert control codes from 
chr$(0) to chr$(26) from the keyboard, so with 
some work the more common printer control 
strings can be embedded in the text. 

Besides some standard wordprocessor-type 
functions such as fill-paragraph and set-fill- 
column (analagous to setting the right margin) 
there are some surprising extras. For example 
Ctrl-T swaps the character under the cursor 
with its nextdoor neighbour (Jf only more 
wordprocessors had that facility); presumably 
this was added by a programmer whose fingers, 
like those of many keyboard users, have mis- 
chievous minds of their own (or one who can 
never quite remember the rules about Is and 
Es). 

It is also possible to convert spaces to tabs- 
and-spaces and vice versa; this can lead to a 
surprising saving in disk space with files con- 
taining data tables, or with a good deal of 
indenting suchas C programs, and MicroEmacs 
can encrypt files so that your program or text 


Hilary Snaden tries the long-running MicroEmacs 
text editor, as updated and recompiled with the C68 


file is inaccessible without the ‘password’ used 
as an encryption key. 


Word count 


There are inbuilt functions for converting 
words or blocks of text to upper or lower case, 
and included in the count-words function is a 
display of average word length, useful as a 
check on writers inclined to verbosity or for 
those uncertain whether to send their latest 
work to the Financial Times or the Sun. This 
review, for example, averages 5.81 characters 
per word. Readers of QL World can make of 
that what they will. 

An aspect of using the program which is a 
little confusing to begin with but which soon 
becomes a revelation is that Enter does not end 
a search or replace a prompt but adds <NL> to 
it. (The prompts are in fact terminated with 
ESCape.) This means that strings at the end or 
the beginning of a line can be specifically 
searched for, and double blank lines can easily 
be replaced by single. This is so useful it is 
surprising that authors of other editors have not 
tried to come up with something similar. 

Any recognised combination of keys can be 
redefined to execute any of MicroEmacs’ ex- 
isting commands; hence, if you find yourself 
using some of the more obscure commands 
relatively often, you can bind them to a more 
convenient keystroke. The combinations 
available are Ctrl-(character), ESC+(character) 
and ESC+Ctrl-(character), leaving plenty of 
room for customisations. You can even rede- 
fine single keys, though this obviously needs to 
be done with some care! 

In addition to the standard key bindings 
common to all versions of MicroEmacs (so, for 
example, should you have access to the same 
program ona Vax mainframe, Ctrl-N will goto- 
next-line just as you are used to), the more usual 
cursor movements have been bound to the 
QL’s cursor keys in such a way that they 
behave much as they do in Quill and the like. 

Any deletions larger than single characters 
can be undone, since the deleted text is kept in 
a ‘kill buffer’ until the next major deletion. This 
is also how blocks of text are moved around. 

Particularly astonishing is the speed of the 
replace-string command; presumably this is 
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largely because the screen is not updated each 
time a substitution occurs unless query-replace- 
string has been called. 


By name 


While all of the most commonly-used com- 
mands are already bound to short key sequences, 
all of those available can also be invoked by 
name - though one has first to know that ESC- 
X brings up the ‘execute-named-command’ 
command! Even this can be made to look 
something like Quill and most other QL text- 
handling software by binding the command to 
the F3 key with the line 

bind-to-key execute-named-command FNO. 

This and any other program configurations 
can also be saved in a file called emacs_rc, 
which will then be read and set up when the 
program is first started. As a practical example 
of this, Qdos traps Ctrl-C before it ever reaches 
MicroEmacs, and so the count-words command 
will not initially be available from simple 
keystrokes. It can be made so by the line: 


bind-to-key count-words M-H 


which uses the otherwise unused combina- 
tion ESC-H. 

If you can’t remember the name of the 
command you want, MicroEmacs can produce 
acomplete or selective list, or typing a space at 
the prompt will fill in the name up to the next 
ambiguity. 

Almost every aspect of the workings of 
MicroEmacs can be altered from within the 
program; there is, for example, an automatic 
Save facility which initially resaves the file 
being edited every 256 characters, but this 
count can be set by the user. A perhaps incon- 
venient but quite understandable exception is 
program dataspace, which must be set either at 
compile-time or with a command line such as: 


EX flp1_emacs;”% 122880" 


which will set the dataspace to 120K. Note 
that you need QJump’s Toolkit 2, or some other 
enhanced EXEC command to do this, otherwise 
the default of 64K will be used. The current 
version of MicroEmacs will, therefore, just fit 
in a 256K machine. MicroEmacs will work 
with less dataspace, but at a noticeably lower 
speed. As with other programs, though, if little 
headroom in terms of ram is left, disk access 
will be slowed as Qdos will have little space 
available in which to set up slave blocks. 


Windows 


One of the most interesting of MicroEmacs’ 
features is that it is possible to work on several 
different files concurrently, and to divide the 
screen horizontally into a number of windows 
which may display different files or different 
parts of the same file. However, if the same 
portion of text is displayed in two windows, 
screen handling can no longer keep up with 
with even an average typing speed, though it 
seems to catch up eventually. 
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The buffers used for each file can have the 
main editing modes (for example, overwrite, 
automatic word-wrap and case-dependent 
searching) set independently of the others. 
Moving text from one buffer to another is quite 
straightforward. 

Potentially the most powerful of 
MicroEmacs’ facilities is the macro language. 
This works something like Editor’s command 
files but in a far more sophisticated and flexible 
fashion: not only are the inbuilt text manipula- 
tion procedures available but there are anumber 
of mathematical and logical functions and 
structures, so that a complete macro may end 
up looking like an Archive program. The 
‘programs’ can be invoked from disk or a text 
buffer, or can be built into MicroEmacs as a 
numbered macro or named procedure. As a 
relatively unsophisticated example of what can 
be done, the listing shows a procedure which 
(after a fashion) renumbers a SuperBasic pro- 
gram file. 

Would-be programmers should beware of 
the pitfall that MicroEmacs does not recognise 
the abort-command keying (Ctrl-G) when it is 
in the middle of a while construct, unless it has 
been specifically programmed in, as in the 
example. This should really have been men- 
tioned in the documentation, as it is so easy, 
even with a macro debug facility, toend up with 
a perpetual loop, particularly while developing 
applications. 


SOFTWARE FILE 


Source code 


The public domain disks include the com- 
plete source code (about 475K of it) and a 
further 182K of documentation comprising a 
users’ manual, a learn-as-you-go tutorial, anda 
file which, while originally intended to provide 
on-screen help, may be usefully printed out as 
a crib sheet. 

If you are familiar with C and have a suitable 
compiler (the C68 compiler with which the 
current ready-to-run version of MicroEmacs 
was prepared is also available in the public 
domain) you can even hack around the original 
code to produce your own customised edition 
apart from the configuration that can be done 
from within the program itself. Since the source 
is likely to remain under development for the 
forseeable future, and it is in the public domain, 
there is little chance of users being left with 
abandoned software. 

Given the amount of man- and woman-hours 
which have gone into programming 
MicroEmacs, and the range of facilities it has to 
offer, it must represent one of the best value 
programs ever. 

MicroEmacs is available from CGH Services 
and QubbeSoft public domain libraries. At the time 
of writing the new C68-compiled version had not 
percolated through to the Quantamembers’ library. 
For those who wish to experiment further the C68 
compiler may be obtained from the same sources. 


Example MicroEmacs procedure 


store-procedure mm 


; line-number a region 


narrow-to-region 
end-of-file 

set %lines $curline 
beginning-of-file 


set Ynewnum @”’Start number: “ 
set %inc @” Increment: “ 
write-message “Renumbering...” 
!while &les $curline %lines 


lif $pending 


set Ya &asc &gtk 

lif &equ Ya 7 
write-message “[Aborted]” 
widen-from-region 
!return 


lendif 
lendif 


beginning-of-line 
search-forward “ “ 
delete-previous-word 
insert-string %newnum 


insert-space 


set Ynewnum &add %newnum %inc 


next-line 
!endwhile 
widen-from-region 


write-message “Renumbered!”’ 


lendm 


EY 
TOOLKIT 


Part two 


Simon Goodwin 
wraps up his QL 
windowing project, 
begun in last 
month’s QL World. 


the last issue, DIY Toolkit in 


troduced seven new keywords 
which allow QL programs to 
save, compress and restore 


overlapping windows. This 
article presents the remainder of the as- 
sembler source for these keywords, ex- 
plains their inner workings, and discusses 
further applications of the code. 

If you missed the last issue, or do 
not wish to re-type my listings, you can 
obtain complete source and object code 
for Volume W, DIY Windows, on disk or 
microdrive cartridge, with documentation 
and extra example programs. Write to DIY 
Toolkit at Cwm Gwen Hall, Pencader, 
Dyfed, Cymru SA39 9HA, or call 0559 
384574. 

Send a stamped self-addressed 
envelope for details of the volumes cur- 
rently available. DIY Toolkit Volumes cost 
£3 each, plus £4 per order to cover disks 
and processing costs. If you have no disk 
drive please enclose one cartridge for 
each volume required. 


Icons for Qdos 


The window routines can be used to 
display and highlight small pictures, or 
‘icons’, on the QL screen. These may be 
stored on disk and displayed with a short 
SuperBasic loader. You can design these 
with programs like GraphicQL, The 
Painter or Eye-Q, and extract them from a 
screen image file with W_STORE or 
W_CRUNCH. 

It is convenient to use positions and 
widths that are an exact multiple of eight 
pixels, such as 16, 24 or 32 pixels. 
Monochrome 382 by 32 pixel icons occupy 
1/128th of the screen, and use 136 bytes 
each; four colour 16 by 16 pixel icons 
weigh in at 72 bytes. 
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You may prefer to use monochrome 
icons 16 pixels square, taking 40 bytes each, 
and SET_RED 1 to highlight one, changing a 
green on black image to white on red. These 
file sizes exclude the ALCHP heap overhead 
of 20-27 bytes per allocation. 

With DIY icons and window control, 
you are well on the way to a complete 
‘WIMP’ system of Windows, Icons, Menus 
and Pointers. The missing bits can simply 
be hacked together in SuperBasic, but you 
may prefer to use ready-made compo- 
nents, such as Qmenu from Jochen Merz. 
Tony Tebby’s pointer interface provides a 
standard way to read mice, joysticks or the 
keyboard; it appears on Quanta library 
disk Specials 0. 


* SET_RED #ch% , flag% 

* 

setred bsr.s 
subq.w 
bne.s 
mave.w 
bsr.s 


check_pat 
fill_lines 
red lines 


* 

bad_param moveq 
bra.s 

chan_error moveq 

quick exit addq.1 
rts 

* 


® SET_GREEN #ch% , flag% 
% 


setgreen bsr.s 
subq.w 
bne.s 
move.w 
bsr.s 
tst.w 
bpl.s 
addq.1 
lea.1 
bra.s 

* 


[i=Set @=Clear -i=Copy to red bytes] 


get_channel 
#2,d03 
bad_param2 


Read channel number 
Check parameter count 
Two are expected 


2(ai,a6.1),d& Fetch the flag 


find_window 
dé 

red lines 
#1,04 

fill lines 
#-1,d6 


Copy green bytes te red 
Point at odd (red) bytes 
If Dé=4, leave it alone 
Otherwise, set all bits 


fill_bytes,a3 Fut Dé in alternate bytes 


scan_lines 
red _bytes,aa 
scan_lines 


#-15,0@ 
quick _exit 
#-6,da 
#4,a7 


get_channel 
#2,d3 
bad_param2 


Point at next line 


BAD PARAMETER error 


CHANNEL NOT OPEN error 
Tidy the return stack 
Return subroutine errors 


Ci=Set @=Clear -1=Copy to green bytes] 


Read channel number 
Check parameter count 
Qnly one is expected 


2lai,aé.1),d6 


find_windaw 
dé 
check_pat 
#1,a4 


Set or clear even bytes 
Start with the red byte 


green_bytes,a3 Point at byte copier 


scan_lines 


* FIND_WINDOW — locates window details from channel definition 


* 

find_window lea.1 
moveg 
moveq 
trap 
tst.1 
bne.s 
Move.w 
move. 
movea.l 
swap 
mule 
tst.w 
beq-s 
1sr.l 

no_crunch addq.1 
addq.-1 
move. 1 
swap 
move.w 
isr.w 
subq.w 
swap 
subq.w 
rts 


* 

bad_range moaveq 
rts 

bad param2 moveg 

exit2 rts 

* 


window_ext,a2 Point AZ at EXTOP code 


#-1,d3 
#9,dG 

#5 

de 
quick_exit 


#-15,d0 


* W_SHOW #ch% , base_address 
* 


show lea.l 
cmpa.l 
bne.-s 
subq.1 
bsr 
movea.1 
addq.1 
movea.w 
jer 


16(a3),a4 
a4,a5 
bad_param2 
#8,a5 
get_channel 
aS,as 

#8, a5 
$118.w,a2 


(a) 


Wait indefinitely long 
SD.EXTOP trap key 

Call via Qdos 

Z signals ERR.OK 

Return error directly 
DG is window line count 
Preserve width & height 
Preserve base address 
Recover line width 
Compute storage needs 
Are we crunching? 


Halve space needed 
Allow for size & depth 
Allow for link & flag 
Preserve size needed 
Retrieve line width 
Count words not bytes 
Adjust for DBRA later 


Adjust for DBRA 


OUT GF RANGE error code 


BAD PARAMETER error code 


Re-displays stored windows 


Point A4 past parameter 2 
Are there 2 parameters? 


Forget the first for now 
Retrieve parameter 2 


CA.GTLIN, get a long 
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DIY TOOLKIT 


Code commentary 


The first part of the source code for 
DIY Windows appeared in the previous 
DIY Toolkitcolumn. The remainderis listed 
this month, with notes on the overall de- 
sign. | shall start by discussing the first 
part, so you may like to refer to Listing one 
from last month’s QL World. 

The window routines have many 
common features: they all take a window 
as a parameter and scan through the 
corresponding area of QL display memory. 
Itfollows that much code is shared between 
the keywords, and you need to understand 
the whole in order to make sense of the 
parts. After the usual snippet to introduce 
the new commands and functions to 
SuperBasic, the code begins by fetching 
parameters for W_CRUNCH, the function 
which stores a window in compressed 
form. 

Much of the code for W_CRUNCHis 
shared by the next command, W_STORE. 
The distinguishing feature is the value in 
register D6, which records the way the 
image is to be compressed. W_STORE 
sets D6 to zero, indicating that both red 
and green bytes are to be stored. 
W_CRUNCH copies its second parameter 
to D6; this is a QL colour-code: two for red 
or four to store only green bytes. 

Both functions use the subroutine 
GET_CHANNEL to fetch parameters. This 
evaluates all the parameters as integers, 
using the CA.GTINT vector, which leaves 
the number of values found in register D3. 
W_STORE checks for a single parameter, 
the channel number. W_CRUNCH also 
expects the compression indicator, so it 
reports a ‘bad parameter’ error if D3 is not 
setto two after the callto GET_CHANNEL. 

Both these extensions return a value, 
so it is important not to leave unwanted 
values on the maths stack, where they 
might get in the way of the result. 
GET_CHANNEL tidies the stack with 
ADDQ.L#2,$58(A6) after reading the Basic 
channel number, and returns with the 
corresponding Qdos channel ID in AO. 
W_CRUNCH uses the same instruction to 
unstack the compression indicator. 

GET_CHANNEL checks for several 
potential errors and returns directly to the 
SuperBasic interpreter with an error code 
in DO if a problem is found. The code at 
QUICK_EXIT discards the subroutine re- 
turn address so there is no need to check 
DO after each call to GET_CHANNEL. 
They only return if all went well. 


Overflow report 


GET_CHANNEL reports ‘overflow’ 
or ‘error in expression’ if the parameter is 
not a valid integer, and ‘bad parameter’ if 
itis negative. It signals ‘channel not open’ 
if the channel has been closed or never 
opened. 

W_STORE and W_CRUNCH share 
code from SAVE_WINDOW onwards. First 
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bne.s 
move.1 
bmi.s 
btst 
bne.s 

* 

* Now D7 is the buffer 

* 
movea.l 
move.w 
bsr.s 
movea.1 
addq.1 
cmp.1 
bne.s 
cap.w 
bne.s 
addq.1 
subq.w 
bmi.s 
bne.s 
addgq.1 

byte_lines lea.l 
bra 

word lines lea.l 
bra 

* 

# Find SCR_BASE (A1.L) 

* 

window_ext moveq 
cmp.1 
beq 
move.w 
Isr.w 
belr 


movea.l 
adda.w 
move.w 
mulu 
adda.1 


moveqg 
add.w 
add.w 
isr.w 
belr 

sub.w 


swap 
move.w 
maveq 
ris 

* 


exit2 
@(ai,a&.1),d7 
bad_param2 
40,07 
bad_param2 


Return D@ error code 
Pick up the base address 
It should be positive 
and even 


base address and A@ is the channel ID 


d7,aZ 

1G (a2) ,dé 
find_window 
d7,ag 

#4, aG 

(ag +,d5 
bad_range 
(a@id+,d4 
bad_range 
#2,aa 

#2,d6 

word lines 
byte_lines 
#1, a4 
load_bytes, a3 
scan_lines 
load_words, a3 
scan_lines 


AZ —> RAM buffer 
Check compression flag 


A@ —> RAM buffer 
Skip the ALCHP link 
Check total space used 


Check line count 


Skip the CRUNCH flag now 
Check the CRUNCH flag 

If <2, restore both bytes 
32, set green bytes only 
Point at first red byte 


LINE_WIDTH%Z (Di.H) LINE_COUNTZ (Di.W) 


#46, 0 
(a®) , dai 
bad_param2 
24 (agi) ,do 
#2,d8 

#0, 10 


S@(ag),al 
d@,al 
26(aG) di 
#128,d1 
di,ai 


HO,d1 
24 (aG) dt 
28 (as) ,d1 
#2,d1 
HD, d1 
dad 


di 
3G(a),d4 
HG, ds 


* Line scanning routines, used by JSR 


* 

save_bytes move.b 
addq-1 
dbra 
rts 


* 

fill_bytes move. 
addgq. 
dbra 
rts 

* 

green_bytes move. 
addq. 
dbra 
rts 

* 

red_bytes move. 
dbra 
rts 

* 

lead_bytes move. 
addq. 
dbra 
rts. 

= 

load_words move. 
dbra 
rts 

oa 

swap_words move. 
move. 
move. 
dbra 
rts 

* 

save_words move. 
dbra 
rts 


(a4)+, (a+ 
#1,a4 
d2,save_bytes 


dé, (a4) 
#2, a4 
d2,#ill_bytes 


(a4) ,—-(a4) 
#3,a4 
d2,green_bytes 


(a4)+, (a4)+ 
d2,red_bytes 


(a+, (a4)+ 
H#i,ad 
d2,load_bytes 


(ai)+, (a4)+ 
d2,load_ words 


(a4)+,d4 

(a4) ,-1(a4) 
di, (ad+ 
d2,swap_words 


(a4), (ad) 
a2, s5ave_words 


Preset MEM length 
Check this channel 
Reject MEM definitions 
Fetch margin in pixels 
Divide by 4 

Make even word offset 


Locate the screen start 
Adjust for left margin 
Fetch top margin 

Scale for 128 bytes/line 
Al —> first window word 


Round to word boundaries 
Allow for left margin 
Allow for width 

Divide width by 4 

Make word offset even 

Di is line width in bytes 


Put byte width in Di.H 
Put line count in Di.L 
Indicate no error 

(AS) in SCAN_LINES 
Copy from screen to RAM 


Skip the other byte 
Repeat for entire line 


Copy pattern to byte 


Advance to next word 


Copy red byte to green 
Point at next red byte 


Copy a green byte to red 


Copy from heap to screen 
Skip the other byte 


Copy from RAM to screen 


Fetch green byte 
Copy red to green 
Store green over red 


Copy from screen tao RAM 


they call FIND_WINDOW to read details 
into registers from the channel definition of 
the window. Thisinturncalls anSD.EXTOP 
extended operation routine, which tempo- 
rarily replaces the channel ID in AO with the 
address of the channel details. SD.EXTOP 
sifts out non-display channels, reporting 
‘bad parameter’. 

The FIND WINDOW subroutine 
works out the location and storage re- 
quirements for the window. By the time it 
has finished, A1 points to the first word of 
the window in display memory, the amount 
of space needed is in registers D1 and D5, 
with the width of each window line in DO 
and the number of lines in D4. 

The width is measured in sixteen bit 
words, with one subtracted from DO and D4 
to suit the DBRA loop instruction, which 
counts down from the initial value to -1. 
This fiddling around is justified because it 
simplifies the keyword routines, which all 
use FIND_WINDOW. 

The next step is to allocate memory 
forastored image. MT.ALCHP attempts to 
reserve D1 bytes on the Common Heap. If 
this works, the space is prefixed with ‘Bufa’, 
sothatthe DIY Toolkit DISCARD command 
knows that it can safely be released. The 
space is also added to the list maintained 
by Toolkit 2, so it can be released with 
RECHP or CLCHP, and automatically freed 
after LOAD, LRUN or NEW. 


Linked list 


Toolkit 2 uses the first four bytes of 
each heap allocation made with ALCHP to 
link the allocations into a list. The un- 
documented system variable at 224(A6) in 
the SuperBasic area normally holds zero, 
but Toolkit 2 updates this to point to the link 
in the most recent ALCHP space. 

In turn, this link may contain the 
address of another link, at the start of 
another ALCHP space, or zero to signify 
the end of the list. CLCHP and the com- 
mands that remove the current program go 
through the list and deallocate each space. 
The list is ignored if you do not have Toolkit 
2 on your machine. The next eight bytes 
indicate the size of the stored image. First 
comes along word, the total size requested 
in bytes, followed by two words: the number 
of pixel lines in the window (less one to suit 
DBRA), andthe compression indicator held 
in D6. All the remaining space is used to 
store window pixel information, read from 
the screen display. 


Shared code 


The subroutine labelled 
SCAN_LINESis central to all DIY Windows 
keywords. My original keyword routines 
each used a double loop to scan the win- 
dow and process each word of display 
memory. The outer loop stepped from line 
to line, while the inner loop processed the 
individual words of each line. This was 
rather a waste of memory, as the same 
instructions were used to step between 


5 


show-* 
Swap—* 
swap-* 


setred—* 


EVPftve oe veces 


@ 


2 
store—* 


crunch—* 


Evrzecrvrese 


:2] 


3S new PROCedures 


6, W_SHOW? 
6,° W_SWOP’ 
6,7 W_SWAP* 
7,°SET_RED* 


setgreen—* 
9, * SET_GREEN* 


End of PROCs 


2 new FuNctions 


7,7 W_STORE* 


8, > W_CRUNCH? 


End of FNs 


lines in every case. 

The improved version is almost as 
fast, yet 48 bytes shorter, because the 
shared subroutine SCAN_LINES is used 
to step between lines. The action performed 
on each line is determined by the value in 
register A3 which points to a distinct sub- 
routine for each possibility. In every case 
D2 indicates the line width, and A4 points 
to the first word of each line. 

The line manipulation subroutines 
are collected at the end of the listing. For 
instance, SAVE_BYTES copies alternate 
bytes from display memory, at A4, to the 
buffer at AO. SAVE_BYTES is used by 
W_CRUNCH. SAVE_WORDS is the cor- 
responding loop used by W_STORE; it 
copies a word atatime. SWAP_WORDS is 
used by W_SWAP and W_SWOP; it ex- 
changes odd and even bytes in display 
memory. 

All eight routines are called from 
SCAN_LINES, which sets D2 and A4 to 
process each line in turn. The code could 
be 28 bytes shorter if the DBRA D2 loops 
were moved to SCAN_LINES, but this 
would slow things down disproportionately 
because of the need to call a subroutine to 
process each word, rather than each line. 


Wide windows 


Minerva users with wide windows 
might speed up W_STORE and W_SHOW 
by calling the MM.MOVE vector, $158. The 
advantage is slight as they must call the 
vector for each line, unless the window is a 
full 512 pixels wide. The remainder of the 
code for W_STORE and W_CRUNCH 
should be familiar. This ‘normalisation’ code 
is used by many QL extensions. It was 
discussed in my May 1988 QL World col- 
umn and CHANCODE_DOC in DIY Toolkit 
Volume C. It converts the address of the 
heap allocation in D1 into six-byte QL 
floating-point form, so it can be returned to 
Basic. 

You should now be sufficiently cog- 
nizant of the DIY Windows design to un- 
derstand the entire SWAP routine. Only 


ten lines of unique code are needed to 
implement W_SWAP and W_SWOP. The 
first five lines call GET_CHANNEL and 
FIND_WINDOW to read and analyse the 
channel parameter. Then they point A3 at 
the SWAP_WORDS subroutine, before 
falling into the SCAN_LINES loop, which 
calls SWAP_WORDS for each line in turn. 

SET_RED and SET_GREEN work 
much the same way, but take an extra 
parameter which determines the routine 
called by SCAN_LINES. If this parameter 
is O or 1 the corresponding colour bytes 
must be set or cleared. In both cases the 
FILL_BYTES loop is used to copy the 
value of D6 into alternate bytes of the 
window. D6 is zero if the bytes are to be 
cleared, or -1 to set all bits. 

If the second parameter is -1 the 
RED_BYTES or GREEN_BYTES loop is 
selected, to copy information from one set 
of colour bytes to the other. Green bytes 
are stored before red ones, so SET_RED 
-1 goes faster than SET_GREEN 1, which 
must step backwards to copy each red byte 
toa green location, then step forward to the 
next word. 

The only unexplained keyword is 
now W_SHOW, which is encoded after the 
FIND_WINDOW subroutine. Unlike the 
others, this takes along integer parameter 
after the channel number. This is the ad- 
dress of the windowcontents to be restored. 
SHOW starts by checking that there are 
two parameters, and hides the second one 
before calling GET_CHANNEL. There is 
no need to check the value of D3 after this 
call as A3 and Aé5 differ by 8, delimiting a 
single parameter. 

CA.GTLIN is used to fetch the long 
word address, which should be positive 
and even. The compression indicator is 
read into D6 before the call to 
FIND_WINDOW, so it gets the size right. 
W_SHOW reports ‘out of range’ if the size 
or depth of the window has changed since 
it was stored. Otherwise it uses 
LOAD_WORDS or LOAD_BYTES to re- 
store the image, depending on the value of 
D6. 
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Various modes 


DIY Windows commands are de- 
signed to suit Mode 4 displays, but they 
can also be used to save and restore Mode 
8 windows. There is a potential problem 
with SET_GREEN and W_SWAP in Mode 
8, as these commands may set flash bits 
as well as green bits, leading to a chaotic 
flashing display. 

The problem occurs because Mode 
8 uses four bits to record the details of each 
pixel. Alternate bits in the even bytes turn 
flashing on and off. Corresponding bits in 
the odd bytes control the blue component 
of the colour, so the odd-numbered ink 
colour blue, magenta, cyan and white make 
the window flash after SET_GREEN or 
W_SWAP. 

To correct this, alter the commands 
to check the display mode with a call to 
MT.DMODE (TRAP #1, DO=16); remember 
to preserve A4 as it is corrupted by the call. 
If Mode 8 is in use you must mask each 
byte stored at an even address with AND 
#170 to ensure that the flash bits are not 
set. This enhancement requires two new 
line-scanning loops, based on 
GREEN_BYTES and SWAP_WORDS. 


The existing code works perfectly in 
the Thor XVI’s extra Mode 12, which re- 
places the flash bits with intensity controls, 
giving 16 colours on an RGBI TTL monitor. 
Italso copes with Minerva’s second screen, 
as it works out the window address from 
SD.SCRB in the channel definition. 


Extra screens 


In fact it is possible to have even 
more ‘logical screens’ in QL memory. 
Sinclair’s display hardware can only read 
screens starting at 131072 or 163840, but 
Minerva lets you move the system vari- 
ables even higherin memory, leaving space 
for extra 32K screens. To display these you 
need to move their contents into one of the 
hardware display areas, with MM.MOVE 
or W_STORE and W_SHOW. 

- If you already read the screen froma 
remote machine using the MEM device 
and network file server, all you need to do 
is change the start address used by MEM. 
The Minerva rom can put text anywhere in 
memory, depending on the values in the 
channel definition. If you have a Gold Card, 
scrolling and output to screen addresses 
above 196607 should be extra-fast as there 
is no need to update slow eight bit memory. 


DIY TOOLKIT 


There are two ways to re-direct text 
and graphics to extra screens. You can 
update SD.SCRB to point to the start of the 
required screen, at any even address, or 
leave the default of 131072 and store atop 
line number greater than 255 in SD.YMIN. 

This value is multiplied by 128, using 
word arithmetic, and added to SD.SCRB to 
find the base address of the window. Thus 
it is possible to position a window that 
overlaps between two screens! | thank 
reader P H Tanner of Glasgow for this idea. 

Such POKEs require the use of 
CHBASE, from DIY Toolkit Volume Q, to 
find the channel definition from Basic. 
Machine coders can get the same effect 
with an SD.EXTOP call. 


Next issue 


DIY Toolkit will be back next month with 
a useful command that will help you generate 
neat formatted reports on the vocabulary of 
your SuperBasic interpreter, on all QLsystems 
from AH to Minerva, occupying only 276 bytes 
of memory. . | am always on the lookout for 
new, useful and concise extensions to the 
Qdos system, and welcome suggestions from 
readers. Please write to DIY Toolkit, care of QL 
World. 
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INFORMATION 

Program: Open World 2.0 
Supplier: Ergon Development, 
c/o Davide Santachiara, Via 
Emilio de Marchi n.2, 42100 
Reggio Emilia, Italy. 
Memory: 256K 

Price: £25 (disk) plus£5 carriage. 
All payable to D. Santachiara. 
Add £4 for sterling cheques; 
nothing for Eurocheques in Lire. 


he QL has various pro 

grams which can be used to 

design pictures both for use 
onthe computer screen and for usein 
printed material. However, for the 
less artistic, itcan be difficult to come 
up with ideas. Other computers have 
a wealth of public domain picture 
files which can be used, some of 
which are truly excellent pieces of 
computer generated art. These canbe 
used in a display or even to improve 
the look of your documents. 

Although there are some public 
domain pictures for the QL, these 
tend to be what is known as ‘clip art’ 
(aseries of small pictures stored on a 
larger screen, which may then be cut 
out from that screen and used to 
embellish desktoppublishing). There 
havehowever been two new releases 
on the QL scene to give the user, 
greater access to pictures designed 
on other computers. One of these 1s 
CGH Service’s SToQL, which al- 
lows you to access various types of 
pictures created on an ST computer 
(a program which T will not dwell 
upon because | am partly responsible 
for it). Open World is the other. 

Open World comes supplied on 
a disk or microdrive together with 
a twelve page A4 manuaf. The 
manual is well written and easy to 
follow. On loading the program 
with the supplied boot program, 
you are presented with a start-up 
screen giving a little information 
about the program. Pressing any 
key will give you the main menu 
from where you can decide the 
type of screen to be converted into 
QL format. 

Provided that you have already 
used a utility (such as Xover) to 
convert a disk containing the 
screens into QL format, Open 
World can then be used to read the 
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disk and convert the following 
screen formats: 


IFF - Generated on an Amiga 
computer (for example using the 
program Deluxe Paint), 

GIF - A standardised screen 
format widely used on PC’s, 

TIF - Generated by different 
scanners and desktop publishing 
programs on PCs and MacIntosh 
computers, 

CUT - A less widely used for- 
mat but available on various com- 
puters. 


Open World uses a system of 

various easy to operate menus to 
choose the various functions and 
sel various parameters. The menus 
are based upon Ergon’s own 
standard menu system, which al- 
lows you to choose options either 
by moving a cursor bar onto the 
appropriate item, or by pressing a 
key associated with each option. 
Their operation is explained in the 
manual and, as with all of Ergon’s 
programs, this makes the program 
easylogelusadio, 
Once you have chosen the type of 
image to convert, a menu is dis- 
played containing a list of the files 
on the given Working Device 
which contain the appropriate 
suffix (eg _GIF for GIF files). 
You can then easily choose which 
file you wish to convert, using the 
cursor bar. Ifyou are lucky enough 
to have the Files-2 system, you 
will be pleased to note that Open 
World supports full sub-directo- 
Ties. 

If you have chosen to convert a 
GIF or IFF file, a small window is 
opened 

on screen which displays useful 
pieces of information about the 
file, which can be used to improve 
theimageilyouwssh. 


Having loaded the file to con- 
vert, you are given a further sub- 
menu which allows you to set the 
conversion parameters. Some 
converted screens may be larger 
than the QL screen, so to help 
with these, you are able to specify 
both x and y offsets for the top 
left hand corner of the screen 
being loaded. On top of this, you 
can also alter the size of the dis- 
play by altering the parameter 
‘Output scr_500x240a6x8’ to the 
desired window size. Other pa- 
rameters allow you to specify 
whether the screen should be 
converted in mode4 or mode8, 
and how much memory should 
be allocated for the conversion 
of GIF files. 

Another option (called Dither- 
ing) allows you to convert screens 
in monochrome mode. Open 
World uses quite a complex al- 
gorithm to ensure that the result- 
ant black and white image retains 
the original resolution and the 
grey scales introduced make a 
fair attempt at retaining the col- 
our diversity. This does however 
tend to degenerate mode8 pic- 
tures, although this will of course 
depend very much upon the 
original image. 

Having set the conversion val- 
ues, you can then choose to proc- 
ess the file. Open World will load 
the appropriate conversion routine 
from the Main Device prior to 
loading the file. The conversion 
process is generally quite quick, 
although the GIF conversion takes 
longer for various reasons ex- 
plained in the manual. Apparently, 
GIF files can be ‘interlaced’ and 
contain up to 256 colours. As a 
result, the image must be loaded 
into memory and then some cal- 
culations must be carried outupon 
the image before it can actually be 
displayed on screen. 


FT WARE FILE 


SOFTWARE FILE 
Onen World 


Rich Mellor looks through a collection of pictures 
which can be easily converted for use by and on a QL. 


Although the QL cannot (cur- 
rently) display as many as 256 
colours (even the THOR XVI can 
only display a maximum of 16 
colours), the conversion programs 
each make a valiant attempt at 
ensuring that the picture retains 
most of its original resolution. 
However, with current levels of 
QL technology, you will need to 
view the image on a black and 
white monitor to obtain the best 
results! 

Having converted the program 
youcan then save the image in QL 
format onto any device, thus al- 
lowing you to use these pictures in 
your own programs or displays. If 
however, you have several pictures 
to convert, it may be useful to use 
the ‘Transfer to ram’ option (pro- 
vided that you have a ramdisk 
available). If you choose this op- 
tion, Open World will transfer all 
of its overlays onto a ramdisk 
(ram1_) and from then on it will 
access the ramdisk for its own 
files, allowing you to use the 
program easily on a QL with only 
one disk drive. 

Overall the program is very 
slick, and enables you to convert 
the various form of images very 
quickly and easily. I only found 
one or two minor errors in the 
program, all of which have been 
notified to Ergon and which I 
understand they will soon rem- 
edy. If you are in need of a few 
images to get you started, I un- 
derstand that Ergon can also 
supply two disks (for £2 each) 
full of GIF and IFF screens. I 
have seen a few of these screens 
and can say that they would ap- 
pear to be of very good quality. 
Many users will undoubtedly find 
ause for such a program, particu- 
larly those with access to bulletin 
boards, which seem to contain an 
endless stream of such images. 
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INFORMATION 

Program: QMenu 

Supplier: Jochen Merz Software 

Im Stillen Winkel 12 

4100 Duisberg 

West Germany 

Price: £12.00 plus VAT, plus £4.50 carriage 
Updates cost £5 plus £4.50 carriage. 

Q tension Thing (special toolkit), menu 

_rext’, which provides easy-to-use 

menus and a special scratch-pad area. 
Menu_rext defines two extension things, 
“Menus’and‘Scrap’. 

The advantage of writing a toolkit as an 
extension Thing is that it is not specific to 
SuperBasic, and may be used from other 
languages such as C or Forth. Most normal 
QL toolkits can only beused from SuperBasic. 
All the work required to handle Things in 
your QL is handled by the Thing System in 
the Qjump file ‘hot_rext’, which is bundled 
with Qpac Iand II, Qd3, DataDesign, etc. The 
Thing system is a (linked) list of named 
resources that may be used by QL programs 
in an ordered manner. 

Qmenu provides enough information to 
use the ‘Menus’ and ‘Scrap’ extensions with- 
out having to worry about how to use exten- 
sion Things. Things are given a technical 
explanation in chapter 17 of the Qdos Refer- 
ence Manual available from Jochen Merz 
software for £30 excluding postage. 

Expanded QLs are beginning to see more 
and more extensions building upon other ex- 
tensions. First seen in Qram, PTR_GEN han- 
dles the pointer and added handling for extra 
graphic objects, while WMAN built upon 
PTR_GEN to provide an easy-to-use menu 
system. Programmers find WMAN hard to 
use from their programs, as they have to 
wrestle with Qptr, the documentation for 
PTR_GEN and WMAN. Hot_rext, introduced 
in Qpac 1, contains the Thing system and the 
Hotkey System IL. 


menu is the documentation for an ex- 


Co-operation 


‘Menus’ follows this theme of co-opera- 
tion, using WMAN and Hot_rext. The 
‘Menus’ extension uses the Thing system 
(hot_rext) to let the rest of the system know 
that it is “in the house’. All a program has to 
do is to ask the Thing system if it can use the 
Thing called ‘Menus’. To provide the easy- 
to-use, pointer-driven menus, the ‘Menus’ 
Thing uses the Window MANager, WMAN. 
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WARE FILE 
Omen 


Qmenu helps programmers use parts of the QJump 
Thing system without mastering the entire system 
Ian Bruntlett assesses it. 


A SuperBasic program demonstrating the uses of Qmenu 


100 REMark QmenuQLW2_bas (C) lan.R.Bruntlett April 1991, 1992 

110 REMark demo of new qmenu, SELECT_LIST 

120 REMark 5/5/92 modified for more useful file picking 

130 __Compiled%=1 

140 REMark $$asmb=flp1_OutIn_rext,0,54 

150 REMark $$off 

160 _Compiled%=0 

170 REMark $$on 

180 IF _Compiled% THEN OPEN #0;’con_512x256a0x0':OUTLN #0;512,256,0,0 
190: 

200 REPeat Loop 

210 Option=SELECT_LIST(‘SLST demo’,’1. Stuff filename\2. Stuff file from dev\3. Stuff device\4. Execute 
job\5. VIEW a file\6. Set PROGDS$\7. Edit PROGD$\8. Set DATADS\9. Edit DATADS$\A. Edit stuffer’,,,10) 
220 SELect ON Option 

230 =0:PRINT #0;’ESCape!’:EXIT Loop 

240 =1: 

250 _—fileS$=FILE_SELECTS$(‘Stuff filename’) 

260 IF file§$<>” THEN HOT_STUFF file$:EXIT Loop 

ef0! =2: 

280 _Hk$=FILE_SELECT$(‘filename to stuff’, DIR_SELECT$(‘directory for stuff’,,,,2),,,,,2):IF _Hk$<>” THEN 
HOT_STUFF _Hk$:EXIT Loop 

290" =3: 

300 _Hk$=DIR_SELECTS(‘directory to stuff,,,,2):IF Hk$<>” THEN HOT_STUFF _Hk$:EXIT Loop 
310 =4: 

320 _file$=FILE_SELECT$(‘Execute job’,, PROGD$,’_exe’) 

330 IF file$<>” THEN EXEC file$ 

340 =5: 

350 _—_file$=FILE_SELECTS$(‘Pick a file to view’) 

360 IF file$<>” THEN VIEW_FILE file$ 

370. =6: 

380 subd$=DIR_SELECT$(‘Set programme default’) 

390 =‘ IF subd$<>” THEN PROG_USE subd$ 

400 =7: 

410 newPROGD$=READ_STRING$(‘Edit programme default’, PROGD$) 
420 IF newPROGD$<>” THEN PROG_USE newPROGD$ 

430 =8: 

440 subd$=DIR_SELECTS$(‘Set data default’) 

450 ‘IF subd$<>” THEN DATA_USE subd$ 

460 =9: 

470 newDATAD$=READ_STRING&(‘Edit data default’, DATAD$) 

480 IF newDATAD$<>” THEN DATA_USE newDATAD$ 

490 =10:newSTUFF$=READ_STRINGS(‘Edit stuffer buffer, HOT_NAMES(‘‘)) 
500 IF newSTUFF$<>” THEN HOT_STUFF newSTUFF$ 

510 END SELect 

520 END REPeat Loop 

530 STOP 


To keep things simple I will calla menu from 
Qmenu a Qmenu, and any other menu a menu. 
When I give a Qmenu’s SuperBasic name I'll 
put its four character ‘extension thing’ name in 
square brackets after it. 

First of all, are the Qmenus practical? Yes. 
When a user is confronted with a Qmenu, it is 
no different to being given a menu from Qram 


or Qpac II. This is not too surprising, as ‘Menus’ 
uses WMAN (which is also used by Qram and 
Qpac II). It does show that Jochen Merz has 
observed the few guidelines in Qptr which are 
along the lines ‘CTRL F2 causes the informa- 
tion displayed to be refreshed, ESCape removes 
a window without performing any (further) 
action, etc.’. So there are no nasty surprises for 


Sinclair/QL World August 1992 


the user. 

‘Menus’ is-a set of nine specialised menus 
biased towards file handling. The colours of the 
menus can be defined by setting ‘colourways’, 
which are a number from 0-4, the default being 
‘white/green’. As the menus rely on the window 
manager, the programmer must ensure that the 
job the Qmentu is being used in has a ‘managed 
window’ (set by iop.outl, trap #3, d0=$7a). 
SuperBasic programrs are provided with 
OUTLN, an extra toolkit command which does 
this. 

The most impressive of the Qmenus is 
FILE_SELECT$ [FSEL]. This brings up a large 
menu which has two large areas, one to show 
subdirectories (but only on the Miracle hard 
disk and other level-2 device drivers), and the 
other to show a list of filenames. It is very easy 
for the user to change device - a list of the 
directory devices present in the QL is part of the 
menu, choosing one of them causes FSEL to 
display a list of filenames from the new device. 
There is a slight problem with the list of devices 
- if there are two devices that begin with the 
same letter then only the first of those devices 
can be chosen with a single key press. This is 
only a minor problem, as keyboard users can 
still move the pointer to the desired device 
name and ‘hit’ it. 


Hitting 


‘Hitting’ the sub-directories entry pulls down 
a further qmenu - DIR_SELECT$ [DSEL]. 
This qmenu allows you to choose a device from 
‘mdv 1/2, flp1/2, ram1/2, win1/2’, or any of the 
eight user defined sub-directories that may be 
set with Qjump’s Config. This shows a weak- 
ness of Config - there is no ‘update’ function: 
if you configure a piece of software and later on 
receive an updated version, all you can do is to 
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overwrite the old version and configure the 
new version. It would be much more conven- 
ient if I could just tell Config: ‘Here is the old 
configured version, use my configuration 
choices from the old version as the default 
choices for the new version’. é 

‘Hitting’ the file extension entry pulls down 
another qmenu - EXT_SELECT$ [XSEL]. This 
is alist of tencommon file extensions. They are 
common to programmers - 
“bas\pas\asm\txt\c\err\lis\t87\map\exp’. The 
default extensions may be configured by the 
user to suit. 

The FILE_SELECT menu has one more 
trick up its sleeve - it can read the stuffer buffer 
(ALT-Space) so the filename return could also 
be the current or the previous contents of the 
stuffer buffer. 

There is one refinement I'd like to see in 
FILE _SELECT. I would like it to be able to 
show a file (for example, with the Qmenu 
VIEW_FILE) so that the user can make sure a 
certain file is the correct file before clicking 
“Oke 

FILE_ERROR will either return -1 if the 
error to be dealt with is not a file error, or it will 
produce arelevant menu with options for retry/ 
abandon/overwrite, etc, returning a unique value 
for each user choice. This is a new addition to 
Qmenu. 

VIEW_FILE [VIEW] is a relatively simple 
file viewer. It shows a file in a big window and 
allows you to set WRAP ON (lines are wrapped 
around at the end of the window, like COPY 
file TO SCR) or to set WRAP OFF (lines too 
long to fit in the window are truncated, like 
VIEW file). Itis similar to the Qpac?2 file viewer 
- pressing Space reads a further line, Enter reads a 
whole page and CTRL-F2 (Wake) causes the 
beginning of the file to be displayed again. The only 
missing facility is a scroll bar to move quickly from 
one part of the file to another. 
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HOTEEY Buffer: 
4- Directory up 
MARS _oti_p_red 
MARS_aesaul t_red 
MARS _ bomber ped 
MARS couboy red 
NARS _dracula_red 
MF ge dwarf red 
MARS _ferret_red 
MARS _ tmp_red 
HARS_ iron_red 
NARS_jrze_red 
HARS kiss red 
NARS _ licher_red 
MARS_lichen2_red 
MARS _ | Ccherns_ red 
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Config 


New versions of Qjump’s Config now use 
the FILE_SELECT menu if it is present. Now 
you have the strange situation of being able to 
run Config, which in turn will use menu_rext to 
get a filename from the FILE_SELECT menu, 
which in turn gets configured by Config! This 
kind of co-operation should be more frequent. 

The other qmenus are less file-oriented: 


READ_STRING$ [RSTR] brings up a small 
window with a title and prompt and allows the 
user to edit some text (possibly a file name). 

REPORT_ERROR [RPER] brings upasmall 
window with a standard Qdos error report in it 
and waits for the users to acknowledge its 
existence - then it removes itself. 

ITEM_SELECT [ITSL] brings up a small 
window with a title, prompt and up to three 
options to be chosen. Despite having three 
options, this menu can still be used to display a 
Toolkit 2 look-alike ‘yes/no/all/quit’ prompt as 
it returns | to 3 for a selected option and 0 for 
ESCape. The options may be chosen by press- 
ing the first letter of the option name or by 
clicking an option with a mouse. 

Choice%=item_select(‘QLW Test 
menu’,’ You have no option but to choose 
one’,’No’,’ All’,’ Yes’) 


During the passage from Qmenu version two 
to version three, Qmenu has diversified into list 
handling. There are three list handling routines 
- SELECT_LIST, SELECT_LISTS. and 
LIST_SELECT. Only LIST_SELECT is meant 
to be used these days - the SELECT_LIST 
routines are only included for compatibility. 

The LIST_SELECT routine will bring down 
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a menu of items, but has two modes of op- 
eration. It can be used as an option list 
where the user can switch options on/off, 
returning when the user has finished set- 
ting the options. Or it can act as a con- 
ventional menu, returning when the user 
has selected a single option. 

The other extension Thing, “Scrap Ex- 
tensions’, handles the ‘Scrap’. The ‘Scrap’ 
is an area of memory which can be used 
for memory-based importing/exporting 
between programs. The programs have to 
specifically access the scrap, so it won’t 
be used by the Psion programs. 

There are SuperBasic commands and 
machine code routines to clear the scrap, 
put information in it, find out what kind 
of information is in the scrap and to read 
the scrap. 


Documentation 


So now you have 
been introduced to 
‘Menus’, what about 
the documentation 
and facilities for pro- 
grammers? In no way 
do the above descrip- 
tions render the 
“Qmenus’ documen- 
tation redundant. The 
manual seems to have 
been written in the 
“Qptr’ style of manual 
writing, that is, con- 
cise and to the point. 
Occasionally it is too 
concise - the assem- 
bly language pro- 
grammer would feela 
bit let down if all there 
was to go on was the 
manual. Fortunately, 
there is a full demo in 
assembler on the disk, 
and the source files 
are provided. 

To access the 
‘Menus’ from assem- 
bler, Jochen Merz 
provides some as- 
sembly language 
source code files. 
Previous versions of 
Qmenu provided S- 
ROFF (Sinclair 
Relocatable Object 
File Format) files that 
needed a compatible 
assembler. Now that 
the source code for the 
access routines is 
provided, you can use 
Qmenu with any QL 
assembler. 

If you are unfamil- 
iar with the ‘Thing’ 
system, you should 
read the Qjump docu- 
ment ‘thing _ext’ on 
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the Quanta SPECIALS_0 disk before us- 
ing Qmenu. You may find my 
“Qdos_Listthg_bas’ on the CGH Services 
MISC PD disk a handy way of finding 
information on Things. 

Despite those reservations, Qmenu is 
definitely usable by assembly language 
programmers. Each menu is defined rea- 
sonably well, although the manual occa- 
sionally returns to being too concise. For 
instance, the FILE SELECT menu can 
modify the directory string or extension 
string passed to it. This is explained away 
with “If the update bit in the directory or 
extension parameter is set, then, if the 
user changes the extension or the direc- 
tory, the string is updated (if it is not a 
key)”. Which update bit? Could it be in 
the definition of the Thing parameters in 
‘Menus’ or does it refer to the parameter 
block that we pass to the qmenu code 
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itself? 

The SuperBasic programmer fares bet- 
ter than the assembly language program- 
mer as far as documentation goes. Each 
SuperBasic extension is listed and de- 
fined. At the moment the ‘SuperBasic- 
Thing’ interface cannot handle multiple 
return parameters, so one or two facilities 
are unavailable from SuperBasic. It even 
mentions some facilities that are due to 
be implemented. 


Serious 


If you are a programmer who is going to 
make serious use of qmenus within your 
Own programs, buy Qmenu. You are go- 
ing to need it. A dabbler could get by on 
guesswork without Qmenu, but would end 
up not using the full facilities of the 
‘Menus’ extensions. 

The ‘Menus’ exten- 
sions are very useful 
and easy to use in a 
program. If you havea 
small program which 
would be very useful 
but the user interface 
work via Qptr would 
be too much effort, use 
the Qmenus. You 
won't have the degree 
of control that Qptr 
gives you, but the re- 
sult will be a saving in 
time. All that is miss- 
ing now from Qmenu 
is a ‘main window’ 
menu which has indi- 
vidual ‘Qmenus’ built 
into it, placed by the 
programmer, waiting 
to be invoked. 

I have two simple 
SuperBasic programs 
which have been made 
easier to write and 
better to use by 
Qmenu. One, ‘vdat’, is 
a filter that uses 
SELECT_LIST when 
deciding which Psion 
printer driver to list. 
The other, a test bed 
for this article, is ona 
hotkey to set Toolkit 2 
defaults from the 
DIR_SELECT$, stuff 
a filename from 
FILE SELECTS, etc. 
Both were simple pro- 
grams made more 
useful by Qmenu. 

People who are go- 
ing to use the ‘Menus’ 
extensions only in 
packages that use it 
(such as Easy Pointer 
or Qd2/3) will not gain 
anything by buying 
Qmenu. 
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Listing 1 


In part 9 of this series 
for new programmers, 
Alan Bridewell puts his 


KEKE EERE EEE KEE EEE EEE EEE EEE EEE EEE EEE ER EEE ER ERE EEE EE KIER ELE REE EERE RE 
“SCREENSAVE ° 

EEKKKEKEKE KEE EER ELER EE ER ER ER ER EE EER ER ER ERE EER EEE EERE EERE EE EE EREL ERE REEL EEE 

THIS ROUTINE WILL PROMPT FOR THE NAME OF A NEW FILE, AND SAVE THE G@L‘S 

SCREEN RAM IN THE FILE 


‘m0 an oe 


PUT PROMPT ONTO SCREEN 


i MESS MOVE. L (A7) ,AO : OR 4(A7),AO OR 8(A7),A0, ETC. 
routines to the use of GB AiAre ate ong 
P d | di LEA.L MESSAGE,A1 ; BASE ADDRESS IN Ai 
= MOVE. W $D0,A2 3; UT_MTEXT VECTOR IN A2 
saving and re-ioading jm pen 
- BRA.S INSTRING ; SKIP MESSAGE 
screen files. . MESSAGE DC.W 44 ; LENGTH OF MESSAGE 
pc.B ‘Name of new screen file’ 
DC.B 10 3 CR,LF 
DC.B *Cincluding device): 


GET STRING FROM KEYBOARD 


; A INSTR MOVE #BUF_LEN,D2 ; LENGTH OF BUFFER IN D2 
ny program which is con | MOVE.W  -#$FFFF,D3 ; INFINITE TIMEOUT 
cerned with screen graphics LEA.L BUFFER,Ai ; BASE ADDRESS OF BUFFER IN Al 
will usually require the ability oer ee ¢ #10_FLINE IN DO 
to save screens to files, and LEA.L BUF_POS,AO } BUF_POS IN AQ 


; SUBTRACT 1 FROM THE Di REMOVES 
: THE LF FROM THE STRING COUNT. 
; PUT NEW STRING LENGTH IN BUF_POS 


also reload such screen 
filesback to the screen. In this section, 
we shall look at routines for doing just 
that. Most of the coding here has been 
dealt with before as smaller chunks, 


SUBG.L #1,D1 


MOVE. W Di, (AQ) 


TRY TO OPEN A CHANNEL TO THE FILE 


wan ae 


LEA.L BUF_POS,AO ; BUF_POS IN AO 


so if you have been following the se- MOVEG #2,D3 ; OPEN NEW EXCLUSIVE FILE 

ries, you should not have much diffi- MOVER #-1,D1 ; JOB ID FOR THIS JOB 

culty with it. However, as they occur ae gow eat ari i 

so often in applications, it seems rea- TST.L Do ; ERROR? 

sonable to include them in the series BEG.S CONT 3 IF NOT, THEN CONTINUE. ELSE:— 


‘a0 ue 


in their own right, rather than leave 
you to construct them from smaller 
chunks. 

Listing one gives the 
Screensave routine. Although it is not 
complicated, it does present a par- 


IF ERROR, THEN THIS IS USED 
BRA MESS : GO BACK TO PROMPT 
ALTERNATIVELY, YOU COULD BRANCH TO CODE TO KILL THE JOB 


IF NO ERROR, THEN THIS CODE IS USED. 
( OR YOU COULD JSR TO A ROUTINE TO GENERATE GRAPHICS, 
AND RTS TO .TRA ) 


7 Py . CONT MOVE. A0,-(A7) 3: SAVE FILE CHANNEL ID 

ticular problem which needs to be | .messz MOVE. L 4(A7),A0 3 CHANNEL ID IN AO 

overcome one way or another. The LEA.L MESSAGE2,Ai ; BASE ADDRESS IN Ai 

problem is this: hn a to save the oo ere I) URBEERT VERIO TN Ae 
JSR {A2) 

screen to afile, we need to open anew BRA.S PRIORITY 3; SKIP MESSAGE 

file on disk or microdrive. To do this, | -MESSA6E2 mg oy Lecare aece: GB ee cee 

we need to first prompt for a file name, DC.B 10 ; CR,LF 


5 


which must then be typed in. This, of 
3 REDUCE THE PRIORITY TO i 


course, means using the screen, which 


5 3 «PRIORITY MOVED #4B,D0 3; #MT_PRIOR IN DO 
is also to be used for the display to be MOVEQ #-1,D1 ; OF THIS JOB 
saved on the file. One solution would MOVEQ #1,D2 3 TO 1 

TRAP #1 Hy 


be to use a window in part of the 
screen not required for the display, 


MONITOR THE KEYBOARD FOR <CTRL><SHIFT?X 


which is fine so long as the display KEYROW LEA.L KEYR,AS ; KEYROW PARAM TABLE IN AS 
: 5 MOVER #$11,D0 3 #IPCOM IN DO 
does not require the entire screen. TRAP #1 


CMPI.B #11,Di 3 IS <CTRLS<SHIFT>X PRESSED? 
BEQ.S PRIOR2 ; IF PRESSED, MOVE ON 
BRA.S KEYROW 3 IF NOT, TEST AGAIN 


| prefer a slightly different so- 
lution. | open a suitable file before 
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setting up the screen to be saved. 
Then when the screen is ready, press- 
ing the appropriate key combination 
will save the screen to the file. 


Two ways round 


This method lends itself to two 
alternatives. If the same program is 
going both to generate and to save the 
display, it must branch off to the rou- 
tines which generate the display after 
the file has been opened, and then 
return to the routine when the display 
is ready to be saved. On the other 
hand, the screen-saving routine can 
be in a separate, multitasking pro- 
gram. In this case, once the file is 
open, the routine can reduce its priority 
to 1 so that it does not slow down the 
screen generating program, and sim- 
ply wait in the background monitoring 
the keyboard for the right combination 
of keys. 

At this point, the user can Ctrl- 
C from the saving program into the 
generating program. When the appro- 
priate key combination is pressed, the 
saving routine will increase its priority 
to 32 again, and save the screen. 

Since a lot of the routine is 
given over to this approach, it is the 
default setting. The alternative is there 
as a one line BRA statement. 

The routine starts by putting a 
prompt into a suitable screen channel 
which was previously opened. It then 
takes a string from the keyboard as a 
channel name, and tries to use it to 
open a new, exclusive channel. If it is 
unsuccessful, it loops back to repeat 
the prompt. If the channel is success- 
fully opened, its channel ID is saved 
on the stack, and a prompt is put on 
the screen to carry on and generate 
the screen which is to be saved. 

After this, the routine reduces 
the priority to one, and then goes into 
a loop waiting for a particular combi- 
nation of keys to be pressed. The de- 
fault setting is to test for Ctrl-shift-X, 
because the three keys are in the same 
keyrow, and itis an unusual key com- 
bination. Clearly, you can alter this to 
suit your own requirements. Once that 
key combination has been pressed, 
the priority is raised again to 32, and 
the transfer of bytes from screen ram 
to file goes ahead. Finally, the file has 
to be closed. 


Taking it apart 


If you are interested in taking 
this apart, you will see that itis almost 
entirely constructed of smaller chunks 
from earlier parts in this series. They 
are, in order Message, Instring, Open, 
Message, Priority, Keyrow, Priority, 
Close. The only new bit comes just 
before the final Close. This is where 
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; KEYROW PARAMETER TABLE 

«KEYR DC.B 9 
DC.B 1 
DE.L 9 

ALTER NEXT PARAMETER TO REQUIRED KEYRO 

DC.B 7 
Dc.B 2 


READ KEYROW 
ONE FARAMETER 
LOWEST FOUR BITS ONLY 


TEST ROW 7 
REPLY OF @ BITS IN Di 


wee So as us 


; INCREASE PRIORITY BACK TO 32 

-PRIOR2 MOVEQ #5B,D0 3 #MT_PRIOR IN DO 
MOVEG #-1,D1 ; OF THIS JOB 
MOVE® #32 ,D2 TO i 
TRAP #1 


: 
; TRANSFER BYTES FROM SCREEN TO FILE 
«TRA MOVE.L (A7) , Ad 3; FILE CHANNEL ID IN AO 
MOVE.L #$20000,A1 3; START ADDRESS OF SCREEN 
MOVE. W #SFFFF,D3 3; INFINITE TIMEOUT 
MOVE.L #$8000,D2 3; SCREEN SIZE IN D2 
MOVER #249 ,D0 3 FS.SAVE IN DO 
TRAP #S 
MOVES #2,D0 3 #I10_CLOSE IN DO 
TRAP #2 
EREKKE KEELER EE ER EEKE EKER EE EERE ER ELE EEE EER ER ER ER ER ERE RE EERE ER ER ER ER ERE EEE 
TO BE POSITIONED AFTER THE CODE 
WE NEED ‘BUFFER’ FOR THE STRING AND ‘BUF_POS’ FOR THE STRING COUNT 


.« BUF_LEN 3 LENGTH OF INPUT BUFFER 
5 ‘ 


.BUF_POS : 


3 
.» BUFFER : 


#*** NOTE **** BUFFER SHOULD COME LAST OF ALL. 


: 
3 
i 
5 
§ FREE KR EKER ER EEE EK EERE REE EEER ERE EERE EERE EEE ERE EEREEEREE EEE EEE EEEEREEEREER 
L, 


isting 2 


EEERER EEL EE EER ERE ERE EEE EEE EEE EERE EEL EERERER IER EK EK EL EERE EE ER EER EE EEE 
‘SCREENLOAD’ 

EEEEREEEE EER EE EEE RERE RE KER EEE EERE ER ER EEE ERER EKER ERE LEER EL ER EEE ERE REE 

THIS ROUTINE WILL PROMPT FOR THE NAME GF A SAVED SCREEN, AND LOAD THE 

NAMED FILE INTO THE @L‘S SCREEN RAM 


PUT PROMPT ONTO SCREEN 
- MESS MOVE. L {A7) ,AO : OR 4(A7),AO OR 8(A7),AO0 ETC. 
3 CHANNEL ID IN AO 
LEA.L MESSAGE ,A1 BASE ADDRESS IN Ali 
MOVE. W #D0,A2 UT_MTEXT VECTOR IN A2 
JSR {A2) 
BRA.S INSTRING SKIP MESSAGE 
. MESSAGE DC.W 46 3 LENGTH OF MESSAGE 
DC.B ‘Name of saved screen file’ 
DC.B 10 4; CR, LF 
DC.B “including device): 
5 
3 GET STRING FROM KEYBOARD 
. INSTR MOVEG #BUF_LEN,D2 3; LENGTH OF BUFFER IN D2 
MOVE. W #3FFFF DS INFINITE TIMEOUT 
LEA.L BUFFER ,AL BASE ADDRESS OF BUFFER IN Al 
MOVEG #2,D0 #IO_FLINE IN DO 
TRAP #3 
LEA.L BUF_POS,AO ; BUF_POS IN AQ 
SUBQ.L #1,D1 SUBTRACT 1 FROM THE Di REMOVES 
5 THE LF FROM THE STRING COUNT. 
MOVE.W D1, (Ad) 3 PUT NEW STRING LENGTH IN BUF_POS 


TRY TO OPEN & CHANNEL TO THE FILE 
LEA.L BUF_POS,AO ; BUF_POS IN AO 
MOVEG #1,D3 OPEN OLD SHARED FILE 
MOVEG #-1,Di JOB ID FOR THIS JOB 
MOVE® #1,D0 } #I0_OPEN IN DO 
TRAP #2 
TST.L DO ; ERROR? 
BEG. S GOT_FILE IF NOT, THEN CONTINUE. ELSE:-— 


IF ERROR, THEN THIS IS USED ¢ OR BRANCH TO CODE TO KILL JOB) 
BRA MESS 5 GO BACK TO PROMPT 


IF NO ERROR, THEN TRANSFER BYTES FROM FILE TO SCREEN 
.GOT_FILE MOVE. L #%20000,A1 3 START ADDRESS OF SCREEN 
MOVE. W #$FFFF,D3 3 INFINITE TIMEOUT 
MOVE. L 4$8000,D2 ; SCREEN SIZE IN D2 
MOVER #$48,D0  ; FS.LOAD IN DO 
TRAP #3 
MOVEQ #2,D0 ; #I10_CLOSE IN DO 
TRAP #2 
EERE E LER EE EE EKEEER EER EE EREEREE ELE ER EEE REE EEE EREE EEE REE EEREREER EERE 
TO BE POSITIONED AFTER THE CODE 
; WE NEED ‘BUFFER’ FOR THE STRING AND ‘BUF_POS‘ FOR THE STRING COUNT 


. BUF_LEN 3 LENGTH OF INPUT BUFFER 


i] 
. BUF _POS 3 ; 


3 
« BUFFER 
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the bytes are transferred from screen 
ram to file, using the trap 3 call 
FS.SAVE, which has #$49 in register 
DO. This also requires the start address 
to be saved 

in register A1, the number of bytes to 
be saved in D2, with an infinite timeout 
in D3. This code can be used to save 
any chunk of ram to a file, and works 
like the SBYTES command in Basic. 

Listing two gives the corre- 
sponding Screenload routine. Most of 
itis very similar to Screensave, except 
that as it does not have to wait for a 
screen to be generated, there is no 
need to have the second Message, or 
the Priority and Keyrow chunks in- 
cluded. Obviously, it will need a slightly 
different prompt on the screen, and it 
will open an old, shared file, not anew 
exclusive one. And, of course, it will 
transfer bytes from file to screen ram, 
and not the other way round. To do 
this it uses the trap 3 call FS.LOAD, 
which is identical to FS.SAVE, except 
that it has #$48 in register DO. 

This works like the LBYTES 
command from Basic. We can illus- 
trate the use of these routines with a 
program which will sleep in the back- 
ground, waiting to be called to either 
save a screen to file, or to load a file to 
screen. It will then wake up and send 
suitable prompts to the screen, after 
which it will carry out the appropriate 
save or load. When this is completed, 
it will go back to sleep, waiting for the 
next call. 

The program starts in the 
usual way with Jobstart, and at once it 
opens a suitable console window for 
the prompts and file names using 
Console. It then uses Priority to drop 
its priority to 1 while it waits to be 
called. At this stage, the program is 
looking for three possible key presses, 
Ctrl-S for save, Ctrl-L for load, or Ctrl- 
Q for quit. 


Different Keyrows 


Since Cirl-S, L, and Q are all 
in different keyrows, it needs to use 
Keyrow four times. The first Keyrow is 
to detect the Ctrl key and ignore all 
others. When a Ctrl is detected, the 
other three Keyrows are used to see if 
S, Lor Qis pressed at the same time. 
If none of these is pressed, it loops 
back to test for Ctrl again. If Ctrl-Q is 
detected, the console channel is 
closed and the job killed. 

On detecting Ctrl-S, the pro- 
gram jumps to Priority to bring the 
priority back to 32 so it can work, and 
goes on to Screensave. On complet- 
ing the Screensave routine, the pro- 
gram has to loop back to the first Pri- 
ority, so it can go back to sleep and 
wait for another call. So the single line 
BRA Priority is added to the end of 
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MACHINE CODE 


*eee NOTE **** BUFFER SHOULD COME LAST OF ALL. 


5 
i 


ERE KEELE KEE EEE KEKE EE EE EERE KER EKER EEEEREE EEE EEL EEE EME ERE LEE ERE EERE EE EEE RE 
Listing 3 


ERE KEE EER EE EHE EEE EEE EEE KEEEE ER EER EK ERE EEE EREEEEREREREEREREEEEE RE EER 
‘JOBSTART ’ 


BRA.S START 
DC.L ° 
DC.W $40FB 
---- ALTER CHARACTER COUNT AND JOB NAM 
DC.W 8 F 
DC.B 


3 BRANCH TO START OF CODE 
3 (THIS IS STANDARD FORMAT FOR 
3 START OF A JOB) 
E -——— 

CHARACTER COUNT OF JOB NAME 
“SAVELOAD* 3 NAME OF JOB 


EREEKKEERERE EEE LER EEE ERE ER EER EERE EERE EERE EEE RE EEEEEEE EER EEEEEERERRERER 
‘CONSOLE ' 
OPEN THE CONSOLE CHANNEL 
---- ALTER LABEL TO .START -—--- 
- START LEA.L PBLOCK,A1 
MOVE. W #06, A2 
JSR (A2) 


PBLOCK ADDRESS IN Al 
UT_CON VECTOR IN A2 


SAVE THE CHANNEL ID WHICH UT_CON ROUTINE LEAVES IN Ad. 


MOVE.L AQ,-(A7) 3 SAVE CONSOLE ID ON STACK 


CLEAR THE WINDOW 


MOVE.W HF FFF D3 
MOVED #$20,DO 
TRAP #3 

BRA.S PRIORITY 


INFINITE TIMEQUT 
#SD_CLEAR IN DO 


‘me ae ae sae 


SKIP BLOCK 


DEFINITION BLOCK. 
—--- ALTER WIDTH TO Si2 -—--- 
-PBLOCK DC.B 
DC.B 
Dc.8 
DC.B 
DC.W 
Dc.W 
Dc.wW 
DC.W 


; GREEN BORDER 

3 2 PIXELS WIDE 

; BLACK PAPER/STRIP 
; WHITE INK 

3 WIDTH 

3 HEIGHT 

; X POSITION 

3; Y POSITION 


OooeMNnons 


EKER EEK EEE EEE EEE EE ERE EERE REE EEE EE EE EEE EERE EEE EER ERE ER EEE EREEHERER 
“PRIORITY ’ 

»-PRIORITY MOVEG #%B,D0 

MOVE #-1,D1 

MOVE #1,D2 

TRAP #1 


3 4#MT_PRIOR IN DO 
; OF THIS JOB 

Brel Qi cl 

} 


HELKEHE EEE EERE KEELE EEE EEE EE EKER EEE EE EE EERE ER EEE EEE EL ER ER EEE EKER EEEREEERE 
“KEYROW’ 


- ALTER LABEL TO KEYROW1 AND LOAD ADDRESS TO KEYRiI —---— 
KEYROW LEA.L KEYR1,€3 3; KEYROW PARAM TABLE IN AS 
MOVEG #$11,D0 3 #IPCOM IN DO 
TRAP #1 
CMPI.B #2,D1 
ADDRESS IN NEXT TWO 
BEQ.S KEYROW2 
BRA.S KEYROW! 
KEYROW PARAMETER TABLE 
---- ALTER LABEL TO .KEYRi —--— 
»KEYR1 DC.B b= 


DC.B i 
pc. i) 
---- ALTER NEXT PARAMETER TO 7 ---- 
DcC.B 7 
DC.B 2 


IS <CTRL> PRESSED? 
INES \-+=> 

IF PRESSED, MOVE ON 
IF NOT, TEST AGAIN 


---- ALTER BRANCH 


3; READ KEYROW 


ONE PARAMETER 
3 LOWEST FOUR BITS ONLY 


5 TEST ROW 7 
REPLY OF 8 BITS IN Di 


EKER KEE EE ERE KEKE EE EEE ERE EERE EEE KER ELE EE KEL IESE KER ELIE EEE EE EERE EKER EERE 
“KEYROW 


; -c-- ALTER LABEL TO .KEYROW2 AND LOAD 
» KEYROW2 LEA.L KEYR2,A3 
MOVEG ##11,D0 
TRAP #1 
CMPI.B #8,D1 
ADDRESS IN NEXT TWO 
BEQ SSAVE 
BRA.S KEYROWS 
KEYROW PARAMETER TABLE 
ALTER LABEL TO .KEYR2 ---- 

DC.B 9 

DC.B 1 

DC.L ° 
} ---- ALTER NEXT PARAMETER To 3 —--- 

DC.B 3 ; TEST ROW 3 

DC.B 2 ; REPLY OF 8 BITS IN D1 


ADDRESS TO KEYR2 -—--- 
KEYROW PARAM TABLE IN AS 
#IPCOM IN DO 


IS S PRESSED? 

EINES —-—— 

IF PRESSED, SSAVE 
IF NOT, TEST AGAIN 


ALTER BRANCH 


READ KEYROW 
ONE PARAMETER 
LOWEST FOUR BITS ONLY 


5 
f KERR EKKKEKKKEREKE EERE EKEK EERE EER EEE ER EEEREEEEEREREEREEEEEEEEEEREEERERER 
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Screensave. In a similar way, if the 
program detects Ctrl-L, it jumps to 
Priority to bring the priority back to 32 
and then goes on to the Screenload 
routine. As with Screensave, the 
Screenload routine needs a BRA Pri- 
ority line added to the end so that it 
can loop back to wait for another call. 
The program ends in the nor- 
mal way with Close to close the con- 
sole channel, and Endjob to kill the 
job. So, putting all that together as list 
rather than a flowchart, we get: 


Jobstart, Console, Priority, Keyrow, 
Keyrow, Keyrow, Keyrow, Priority, 
Screensave, Priority, Screenload, 
Close, Endjob. 


Listing three shows all the chunks 
merged together to make the program. 
As before, many of the comments have 
been removed, and extra ones added 
to show exactly what alterations are 
necessary to make the chunks fit to- 
gether. You could, of course, simply 
type in listing three and assemble the 
program, but this would defeat the 
point of the exercise. It will be much 
more informative to merge the indi- 
vidual chunks into one file, and then 
make all the necessary alterations. 


Tailoring 


Having got the program to 
work, the next job is to improve it and 
tailor it to your particular needs. Doing 
this will really show you that you un- 
derstand the programming. 

One obvious improvement 
might be to add some sound, by get- 
ting the program to make a pleasant 
little sound when it has completed a 
save or load successfully, and a less 
pleasant one when it fails to open a 
file for saving or 
loading. If you have been following 
this series, you should have the 
SOUND routine all ready to merge into 
the program. 

When the program starts, it 
produces a blank console window, 
even though you are not ready to use 
it. This is not a major problem, but may 
be a bit annoying. Not only that, but 
the console window stays open the 
whole time, whether it is in use or not. 
It would be tidier for the window to be 
opened when it is needed for a load or 
save, and then closed again after- 
wards. This would make the program 
a bit longer, but would not be difficult 
to produce. However, if you did this, 
you would need to be given some sign 
that the program had loaded properly, 
so make it give another little sound 
just before it goes to sleep, just to tell 
you all is well. 

You can, of course, play 
around with the console window itself 
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5 


3 
3 
3 
3 
7 


MACHINE CODE 


‘KEYROW* 


---- ALTER LABEL TO .KEYROWS AND LOAD ADDRESS TO KEYRS ---— 
KEYROWS LEA.L KEYRS,AS KEYROW PARAM TABLE IN AS 
MOVE® #$11,D0 #IPCOM IN DO 
TRAP #1 
CMPI.B #1,Di ; IS L PRESSED? 
—--~ ALTER BRANCH ADDRESS IN NEXT TWO LINES -—-—-- 
REQ SLOAD ; IF PRESSED, SLOAD 
BRA.S KEYROW4 5 IF NOT, TEST AGAIN 
KEYROW PARAMETER TABLE 
—--- ALTER LABEL TO .KEYRS ---— 
KEYRS DC.B = 3 READ KEYROW 
DC.B i ONE PARAMETER 
pe.L ie] LOWEST FOUR BITS ONLY 
—--- ALTER NEXT PARAMETER TO 4 -—--— 
DC.B 4 
DC.B 2 


TEST ROW 4 
REPLY OF ,8 BITS IN Di 


HEEKER EERE EER EERE ERE EREEER EEE EEE EERE EEL ER EELER EEE EERE EERE ERE EE EEE EEE EEE 
“KEYROW/ 


—-—— ALTER LABEL TO .KEYROW4 AND BRANCH ADDRESS TO KEYR4 —-—— 
KEYROW4 LEA.L KEYR4,A83 5 KEYROW PARAM TABLE IN AS 
MOVEG #$11,D0 5 #IPCOM IN DO 
TRAP #1 
CMPI.B #8,D1 IS @ PRESSED? 
—--- ALTER BRANCH ADDRESS IN NEXT TWO LINES —--- 
BEQ CLOSE IF PRESSED, QUIT 
BRA.S KEYROWL IF NOT, TEST AGAIN 
KEYROW PARAMETER TABLE 
— ~~ ALTER LABEL TO .KEYR4 —--— 


KEYR4 DC.B Sr 3; READ KEYROW 


Dc.B i ONE PARAMETER 

pc. Oo LOWEST FOUR BITS ONLY 
—--- ALTER NEXT PARAMETER TO 6 —-—- 

DC.B & TEST ROW 6 


DC.B 2 REPLY OF 8 BITS IN Di 


ERLE ER EEE EE EEE EER ER EE ERE EEE EEE EEE EE ERE KEEN IEE EE EEE EE EEE EE EEE ERE EEE EE EE 
PRIORITY‘ 


---~ ALTER LABEL TO .SSAVE —--- 
SSAVE MOVEG #$B,DO ; #MT_PRIOR IN DO 
MOVER #-1,D1 ; OF THIS JoB 
MOVEQ #1,D2 3; TO 1 
TRAP #1 ; 


fF BRECKER KKEEREREKRE EERE REE REE EEE REL EEE REE LEBEL ER EEE REREEEREEERREREEREREE 


“SCREENSAVE ° 


} PUT PROMPT ONTO SCREEN 


-=—— ALTERS LABEL TO .MESS1 -—-—-- 


~MESS1 MOVE. L. {A7) , AG 3 CHANNEL ID IN AQ 


—--~ ALTER LOAD ADDRESS TO MESSAGE1 -~——— 
LEA.L MESSAGE1,41 ; BASE ADDRESS IN Al 
MOVE. W $DO,AZ 3 UT_MTEXT VECTOR IN A2 
JSR (AZ) 

-—--- ALTER BRANCH ADDRESS TO INSTRI ---— 
BRA.S INSTR1 ; SKIP MESSAGE 


3-7-7 ALTER LENGTH OF STRING AND STRING BYTES —~-— 


MESSAGE1 DC.W 44 3; LENGTH OF MESSAGE 
DC.B ‘Name of new screen file’ 
DC.B 10 3; CR,LF 
DC.B “(including device): 


FROM KEYBOARD 


LABEL TO INSTRi -—--- 
MOVEQ #BUF_LEN,D2 ; LENGTH OF BUFFER IN D2 
MOVE. W #3FFFF,D3 3; INFINITE TIMEOUT 
LEA.L BUFFER,A1 ; BASE ADDRESS OF BUFFER IN Al 
MOVEQ #2,D0 3 #IOQ_FLINE IN DO 
TRAP #3 
LEA.L BUF_POS,AO ; BUF_POS IN AO 
SUBQ.L #1,D1i SUBTRACT 1 FROM THE D1 REMOVES 
THE LF FROM THE STRING COUNT. 
MOVE.W Di, (AO) 7 PUT NEW STRING LENGTH IN BUF_POS 


5 TRY TO OPEN A CHANNEL TO THE FILE 


LEA.L BUF_POS,AO ; BUF_POS IN AO 
MOVE® #2,D3 OPEN NEW EXCLUSIVE FILE 
MOVEO #-1,D1i JOB ID FOR THIS Jon 
MOVEG #1,D0 #I0_OPEN IN DO 
TRAP #2 
TST.L DO ERROR? 
ALTER BRANCH ADDRESS TO CONTi —--- 
BEQ.S CONT1 ; IF NOT, THEN CONTINUE. ELSE:- 


IF ERROR, THEN THIS 1S USED 
---- ALTER BRANCH ADDRESS TO MESS1 —---— 
BRA MESS1 3; GO BACK TO PROMPT 
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to your heart’s content, by altering its 
size, shape, position and colours, un- 
til it is exactly what you want. 


Incorporating 


When you are really starting 
to feel confident, you could start trying 
to incorporate the routines into other 
programs. A good candidate for this is 
the program Ellipses from part 8 of 
this series. The simplest way of doing 
this 
would be to treat the program Ellipses 
as a subroutine of Screensave, so that 
having opened a file to save the 
screen, the program then jumps to the 
routines to plot a pattern of ellipses. 
When a satisfactory pattern is ob- 
tained, the program returns to 
Screensave to save the screen to the 
file. To make sense of the what follows, 
you will need to be familiar with the 
assembler listing for Ellipses. 

Clearly, you would not need 
the whole of the Ellipses program. The 
Jobstart would be redundant, and you 
could use the same console window 
for the prompts and for the ellipses, 
although this is probably not advis- 
able. Similarly, the Endjob would be 
redundant. The Close routine in El- 
lipses to close the console window for 
drawing ellipses would need to end in 
an RTS to return to Screensave. The 
Screensave routine itself would, of 
course, not need the middle section 
concerned with changing priority and 
monitoring the keyboard. Indeed, since 
sleeping in the background will not 
feature in the program, then Priority 
will not be needed. Putting all that 
together, the list of chunks for merg- 
ing should look something like this: 


Jobstart, Console (for text), 
Screensave (first part), Console (for 
ellipses), Cursor, Writemode, Copy, 
Main (for ellipses routine), Fbyte, El- 
lipse, Updownfp, Updownint, 
Updownint, Updownint, Updownint, 
Close (ellipses console), Screensave 
(last part), Close (text console), 
Endjob. 


If you try this, you have to be careful in 
One or two places watching the stack 
pointer to make sure you put the cor- 
rect channel ID into register AO. You 
will also become aware that the pro- 
gramming is becoming just a bit messy 
because the ‘systematic’ bit in the title 
of this series is breaking down. The 
reason for this is quite simple. As long 
as our chunks of code remain short 
and simple they are easy to put to- 
gether without much change. As soon 
as our chunks become longer and more 
complicated, they also become far 
more specific in application, and when 
we want to use them in a different way, 
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~ CONT 


‘me 0 ee er un 


{MESSS 


IF NO ERROR, THEN THIS CODE IS USED 
---- ALTER LABEL TO .CONT1 ---- 
MOVE. L A0,-(A7) 
MOVE. L 4(A7) ,A0 
LEA.L 
MOVE. W 
JSR 


MESS2 


$D0,A2 
(A2) 


———- ALTER BRANCH 
BRA.S 
DC.W 
DC.B 
DC.B 


PRIORI 
MESSAGE2 3o 
10 


REDUCE THE PRIORITY TO i 

—--- ALTER LABEL TO .PRIOR1 

PRIORI MOVEQ 
MOVEG 
MOVER 
TRAP 


#$B,D0 
#-1,D1 
#1,D2 
#1 


MESSAGE2,AL ; 


MACHINE CODE 


5 SAVE FILE CHANNEL ID 
3 CHANNEL ID IN AO 

BASE ADDRESS IN Al 
3 UT_MTEXT VECTOR IN AZ 


ADDRESS TO PRIORI —-——— 


; SKIP MESSAGE 
; LENGTH OF MESSAGE 


‘NOW CREATE SCREEN TO BE SAVED’ 


3 CR LF 


#MT_PRIOR IN DO 
OF THIS JOB 
TO 1 


MONITOR THE KEYBOARD FOR <CTRL><SHIFT>X 


-—--- ALTER LABEL TO .KEYROWS AND LOAD 

KEYROWS LEA.L KEYRS ,AS 
MOVEQ #$11,D0 
TRAP #1 

=== ALTER TO EMPI.B #11,Di1 =—=—— 
CMPI.B #11,D1 

—--- ALTER BRANCH ADDRESS IN NEXT TWO 
BEQ.S PRIOR2 
BRA.S KEYROWS 


KEYROW PARAMETER TABLE 
ALTER LABEL TO .KEYRS —--— 

Dpt.B icf 
DcC.B 1 
DC.L o 

—--~- ALTER NEXT PARAMETER 7 —---- 
DC.B cA 
DC.B a 


INCREASE PRIORITY 
PRIOR2 


BACK TO 32 
MOVE 
MOVEG 
MOVE® 
TRAP 


#B,D0 
#-1,D1 
#32 ,D2 
#1 


TRANSFER BYTES FROM FILE TO 

TRA MOVE. L 
MOVE. L 
MOVE. W 
MOVE. L 
MOVEG 
TRAP 
MOVER #2,D0 
TRAP #2 

-—--- ADD NEXT LINE TO LOOP BACK —--- 
BRA PRIORITY 


SCREEN 
(A7)+,A0 
#20000, AL 
#$FFFF ,DS 
#$8000 ,D2 
#$49,D0 


ADDRESS TO .KEYRS —--- 
; KEYROW PARAM TABLE IN A3 
3 #IPCOM IN DO 


3 IS <CTRL><SHIFT>X PRESSED? 
LINES = — 

3; IF PRESSED, MOVE ON 

3 IF NOT, TEST AGAIN 


READ KEYROW 
ONE PARAMETER 
LOWEST FOUR BITS ONLY 


TEST ROW 7 
REPLY OF 8 BITS IN Di 


#MT_PRIOR IN DO 
OF THIS JOB 
TO 1 


3 FILE CHANNEL ID IN AO 
3 START ADDRESS OF SCREEN 
INFINITE TIMEOUT 
SCREEN SIZE IN D2 
FS.SAVE IN DO 


; #I0_CLOSE IN DO 


—--- MOVE BUFFER, ETC TO THE END OF THE PROGRAM —--- 
ERK KEKE EEE ERE EERE EERE EERE KEE EEE EEE EE ENE EERE EER EEE HEE EEE RE EE EER EEK 


“PRIORITY 


---- ALTER LABEL TO .SLOAD —---- 

SLOAD MOVEG #$B ,DO 
MOVEQ #-1,D1 
MOVEQ #1,D2 
TRAP #1 


HEE EEE EEE EEE KEKE REE REE EERE ER EERE 
*SCREENLDAD *‘ 
PUT PROMPT ONTO SCREEN 


ALTER LABEL TO .MESS3 ———— 


MOVE. L (A7) ,AO 
---- ALTER 
LEA.L 
MOVE. W 


JSR 


#D0,A2 
{A2) 
---- ALTER 
BRA.S INSTR2 
LABEL TO .MESSAGES -—--—- 
DC.W 46 
DC.B “Name of s 
DC.B 10 
Dc.B 


aaa AL TER 
MESSAGES 


GET STRING FROM KEYBOARD 

LABEL TO .INSTR2 ——-— 
MOVEG 
MOVE.W 
LEA.L 
TRAP 
LEA.L 
SUBQ.L 


#4¢FFFF,D3 
BUFFER ,A1 
aS 
BUF_POS,AO 
#1,D1 


MOVE.W Di, (a0) 


’ 


3 #MT_PRIOR IN DO 
3; OF THIS JOB 
Stet 

5 


KEREEEEEEE EER EREEE EEE EEEEERERERERE 


3 CHANNEL ID IN AO 


LOAD ADDRESS TO MESSAGES ---- 
MESSAGES,Al 3; 


BASE ADDRESS IN Ai 
3 UT_MTEXT VECTOR IN A2 


BRANCH ADDRESS TO INSTR2 ———— 


3 SKIP MESSAGE 


3 LENGTH OF MESSAGE 
aved screen file’ 
3 CRLF 


“t{including device): 


#BUF_LEN,D2 ; LENGTH OF BUFFER IN D2 


3 INFINITE TIMEOUT 

3; BASE ADDRESS OF BUFFER IN Ai 
3 BUF_POS IN AQ 

; SUBTRACT 1 FROM THE Di REMOVES 
THE LF FROM THE STRING COUNT. 
PUT NEW STRING LENGTH IN BUF_POS 
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it usually means that a slightly differ- 
ent chunk would have suited us better. 


Messy Solution 


Clearly our problem with 
Screensave is in linking the input of a file 
name and opening a file, with actually 
transferring bytes to the file, all in one 
chunk. It works quite nicely if we separate 
the save routine and the screen creation 
routine into different programs, but be- 
comes messy when we try to put them 
together in the same program. 

The only really systematic way 
out of this is to go back to the smaller 
chunks of code and merge them together 
in the way that best suits your purpose. 
As | have already mentioned, all these 
smaller chunks except one have been 
covered in earlier parts of this series. 

The exception is the routine to 
save the screen bytes to a file. This is the 
routine SAVE shown in listing four. Al- 
though we have been using it to save the 
screen ram to a file, itcan be used to save 
any section of ram to a file, 
including data, or programs. It requires 
the channel ID of anew, exclusive channel 
in AO, the start address to be saved in A1 
and the number of bytes to save in D2. It 
also requires an infinite timeout (-1) in D3. 

Screenload does not present us 
with the same problems. However, itdoes 
contain a small routine which has not yet 
been shown separately, which you may 
wish to use. This is the Load routine 
shown in listing five. Like Save, it does 
not have to be used to load a file to screen 
ram, but can be use to load any file, data, 
or program, to any part of the ram. 


Ram warning 


But a word of warning is needed. 
Qdos needs to know what all parts of ram 
are used for, because if it doesn’t, it is 
quite likely to suddenly grab some for its 
own use. Also, if you suddenly load a file 
into an area of ram that Qdos has allocated 
for a different purpose, you will almost 
certainly crash the QL. So if you are not 
loading the screen ram, you must make 
sure the ram that is being loaded is prop- 
erly allocated buffer in a program, and is 
big enough to take the whole file. Load 
requires almost exactly the same as Save, 
except that the channel ID in AO must be 
for an old, shared file. 

One final point. Listings one, two 
and three are not supposed to represent 
any optimal or correct way of doing things. 
They are designed to show whatis possi- 
ble, and to help understand how certain 
programming problems may be overcome. 
As you become more familiar with the 
various routines in this series, then other, 
shorter, more elegant, solutions will spring 
to mind. But the basic building blocks will 
almost certainly remain the same, and 
listings four and five are two more of those 
basic building blocks. Happy coding. 


5 


3 
i 
3 
i 


. CLOSE 


MACHINE CODE 


TRY TO OPEN & CHANNEL TO THE FILE 


LEA.L 
MOVEG 
MOVER 
MOVE 
TRAP 

TST.L 
BEQ.S 


BUF_POS,AO ; BUF_POS IN AO 
#1,D3 OPEN GLD SHARED FILE 
#-1,D1 JOB ID FOR THIS JOB 
#1,DO #ID_OPEN IN DO 

#2 

DO 
GOT_FILE 


ERROR? 

IF NOT, THEN CONTINUE. ELSE:— 

IF ERROR, THEN THIS IS USED 

---- ALTER BRANCH ADDRESS TO MESS3 -—--- 
BRA MESSS 3 GO BACK TO PROMPT 

IS USED 

SCREEN 


IF NO ERROR, THEN THIS CODE 
TRANSFER BYTES FROM FILE TO 


MOVE.L 
MOVE.W 
MOVE.L 
MOVEG 
TRAP 
MOVEQ 
TRAP 
---- ADD NEXT LINE TO LOOP BACK 
BRA PRIORITY 
----— DELETE UNWANTED BUFFER. --—- 
KKK KKK EILEEN EIR EEE EIR EEE INL ELE EERIE LEE IEA IEEE IEE RII IIRL IEEE 
‘CLOSE ” 


+ START ADDRESS OF SCREEN 
INFINITE TIMEQUT 

SCREEN SIZE IN D2 

FS.LOAD IN DO 


GOT_FILE #$20000, AL 
#$FFFF ,D3 
##8000 , D2 


#$48 ,DO 


3 #IO_CLOSE IN DO 


CHANNEL ID IN AO 
#I0_CLOSE IN DO 


MOVE. L (A7)+,A0 3 
MOVES ; 
TRAP 3 

BRA.S ii 
KEEEEE EEE KEKE E EEE EERE REE E EEE EEE ERE EKER ERKE REE KE EER EEE EE EEEREREREEEREEEE 
‘ENDJOB‘ 


JOB_END MOVE. W 


JSR 


$0A,A2 ; 
{A2) 


UT_ERRO in AZ 


MOVEQ 45,D0 
MOVEG #-1,D1i 
TRAP #4 


#MT_FRJOB IN DO 


END_JOB ; 
; ID OF THIS JOB IN Di 
3 


REEKEK EE EEE EEE REE EEK ER ERE LEE EE EEEL EEE EE EE EEE EL ER ELE ELE EES ERIE ER EERE ER 
TO BE POSITIGNED AFTER THE CODE 
WE NEED ‘BUFFER’ FOR THE STRING AND ‘’BUF_POS‘ FOR THE STRING COUNT 


BUF _LEN ; LENGTH OF INPUT BUFFER 
BUF_POS A 
BUFFER 3 

«eee NOTE **** BUFFER SHOULD COME LAST OF ALL. 


EXEKEE KEK EE KEKE EE EE EEE LEE EERE EE ES EL EEE EEE ERREEEE EEE REEEE EE EEEEEEE 


Listing 4 


KKK EKER EERE REE EKER EL EEE EE EE EL EL ERE LEE REE EREE EE EEL EL EEE EL EL ERE EEE EERE 
‘SAVE’ 

EEEKEKEE KE REE ER EE EERE EE EEE EE EEE ERE EE EERE EE EE EEE EE EE EEE EE EL EE EEL EELEREER, 
THIS ROUTINE WILL SAVE A FILE FROM MEMORY. 

Ai CONTAINS THE BASE ADDRESS OF THE FILE (‘MUST BE EVEN) 

D2 CONTAINS THE LENGTH GF THE FILE 
SAVE MOVE.L {A7) ,AO 3 OR 4487) ,A0 OR S{A7),AO ETC. 
; CHANNEL ID IN AO 
#$20000,A1 3 BASE ADDRESS OF FILE 
#$8000,D2 3; LENGTH OF FILE 

#¢FFFF,DS 3 INFINITE TIMEOUT 
#249 ,DO 3 FS.SAVE IN DO 
#3 


MOVE.L 
MOVE.L 
MOVE .W 
MOVEG 
TRAP 


EXER EE LER ELE REE EE EEEEEEE EEE EEEEEEEEEEERELEELEEELEEEREEREEEEEEEEEEEEEEERE 


Listing 5 


HELEKKELEK EE EL ER EEE EERE EERE EL EL ERE RE EE EEER ERE ER EEEE EEE EREEEELER EER EEE ERE 
‘LOAD’ 

KREHEE KEK EL HEL KEEL EE ELE EEE ELE REL EE EL ER ER EEE EE EL ELEE EER ER ELLER ERLE ERE 

THIS ROUTINE WILL LOAD A FILE TO MEMORY. 


; Ai CONTAINS THE BASE ADDRESS OF THE FILE (MUST BE EVEN) 
s D2 CONTAINS THE LENGTH OF THE FILE 


LOAD MOVE.L {A7) ,AO 3 OR 4187),A0 OR 8(A7),AO ETC. 
3 CHANNEL ID IN AO 

#$20000,A1 ; BASE ADDRESS OF FILE 
#$8000,D2 ; LENGTH OF FILE 

#3FFFF {DS 3; INFINITE TIMEQUT 

#$49 ,DO 3; FS.LOAD IN DO 


#3 


MOVE.L 
MOVE,L 
MOVE .W 
MOVEG 
TRAP 


KEELE KEL E EEE EEE KEE EEE EE EERE EE EE EEE EERE EERE EERE EEE EEREELEEEREREEREEERERE 
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ADS...MICRO ADS...MICRO ADS...MICRO ADS... MICRO ADS... MICRO ADS... MICRO ADS...MICRO ADS... MICRO ADS... MICRO A 


WEEE UN Ff NEY UD 


MICRO ADS 


Redundant due to GoldCard. 
Expanderam 512K plus 
Cumana D/D interface £40.00 
the two. Call Keith on 081-302 
2266. 

Miracle Systems QL hard disk 
40m byte only £349 GWO save 
£100 pff original price just over 
12 months use. Contact Paul 
Merdinian Forge House, 
Charine Heath, Ashford, Kent. 
0233 712857. 

QL System (JM) 512K Serial 
Printer (80cps) Tandata 
modem. Some _ spares, 
including languages, 
Assemblers, Games, Books 
and Documentation. Offers for 
all or part? 

Tel 0252 724184 

QL System for sale, Three 
QL's, Trump Cardz, Minerva, 
Two Disk drives, Books, Mags, 
ROM Toolkit 2, Software etc. 


£275 ono. Phone Terry 0332 


511273 (Derby) 


QL ROMS AND SPARES 
ROMS, MGE (Spanish, MGF (French), MGG 
(German); JS (English), £20 each. JM (English), 
MDVS. Complete QL MDV Subunit £20, head 
and chassis £10, Microswitch £2, Motor £6. 
Rubber & Plastic Roller £2. MDV2 Stand-off 
spacer + srew £2. ULA £5. Tr 4,5,6,7 set £2. 
MDV peb inc, ULA £11. Prices include UK 
postage. Send SAE for price list of all QL spares. 
Joe Atkinson, 36 Ranelagh Road, Ealing, 
London W5 5RJ (Mail Order Only). 


| 
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QL UNEXPANDED original 
programs plus extras. Back up 
MDV's plus extra drives. No 
MDV failures since new. AH 
version, have changed to 
‘Amiga’ for video titling. Give it 
a good home. 

Tel 051-339 2853. 

FOR SALE OLJS in KBL-128PC 
box 768K T.card dual disk Dual 
MDV PC keyboard battery clock, 
colour monitor 8058 printer, Psion 
suite taskmaster SL Spellbound 
euroword, QL home finance QL 
manual tandata modem £310.00 
cashg buyer collects. Tel: 0243 
771680 

QL JM SYSTEM, comprising 
CUB 895 colour monitor, super 
Toolkit cartridge, centronics 
printer interface, clock battery 
back up _ kitplus fitting 
instructions. Not fitted. Psion 
package £135. Tel 0233 
626713. 


QL REAL TIME 
DIGITIZER 


Digitize moving pictures in real time. Transforms QL into a 
video printer or 3-D image digitizer via a video camera/recorder 
* Digitizes in .02 secs, 

* 256x256 resolution in 8 levels 

* Full, '/4 or 4x '/, screen modes 

* Screen update - 5 or 2.7 frame/sec 

“4:1 grey level 9-pin printer dump. 

* Interfaces to QL ROM PORT 

* Runs.on unexpanded QL and multitasks. 

* P&P 3.00 UK, 9.00 overseas, state MDV or FLP 

CL SYSTEMS, 403 CHAPTER ROAD, DOLLIS HILL 
LONDON NW2 5NG TEL: 081 459 1351 


MICRO ADS 
MICRO ADS 


HARD DISK BACKUP AND FILE MANAGER with subdirectories, 
listings, etc. Needs toolkit. £20 on 3'/2" disk, £15 Quanta members. 
C. Turner, 43 Hamesmoor Rd., Mytchett, Camberley, Surrey. 
0252 541968. 


QTop » ENE] ewe 


QTop The definitive User-Front-End V1.11 SFR 70.-- 

The QL's equivalent to WINDOWS on MS-DOS PC's. The system-manager offers the mainmenus DESK, 
DEVICES, FILES, JOBS, KEYBOARD, PROGRAMS, MY PROGS, TOOLS and OPTIONS with 
over 110 sub-menus. QTop is ideal for Gold-Card or Harddisc users as it supports real Sub-Directories. The 
powerful QJUMP extended Pointer Environment is included and all its facilities are supported. Comprehen- 
sive 41 page manual. 

ArcED The professional Text-Editor V2.6 SFR 39.-- 

The Text-Editor especially for programmers. Written in fast, reentrant machine code (only 20KB). 


Comprehensive 29 page manual. 

ExeQtor The Super-QL in a limited edition/ask for quotation. 

We use the QL PCB, GOLDCARD, QIMI & Mouse, JFC K90 & MF-2 Keyboard, up to 3 discdrives and a 
harddisc (option) to build the Super-QL in a Tower case. QTop and ArcED are included on the system disc. 
Ask for free product information. Software is available on 3.5" or 5.25" disc. All our products are compatible 
with all QL compatible computer. Free updates and user-support. Please specify English or German version. 
Prices including P&P. Send orders with cheques to drawn in SFR to: 


COwWO Electronic 


Urs Konig, Miinsterstrasse 4, CH-6210 Sursee, Tel 045-211478 
or contact TK Computerware (UK) and QLympic Computer Systems (Germany) 


| ADVERTISE YOUR SECONDHAND QL ! 
' ADVERTI R SECONDHAND QL ! 
I I 
'___ EQUIPMENT FREE OF CHARGE. 
COMPLETE THE FORM BELOW (NO FAX'S OR PHOTOCOPIES ACCEPTED. PRIVATE SALES ONLY) 1 

I 
SAKE Please send coupon to: Advertising Department | 
as aated eae fmrial. cUhes aie teeclicualeaue: 
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B DAYTIME TELEPHONE NO .ac.u.:....2.4. SOMOS RIM issue of Sinclair/QL World. i 
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Please supply QL’s, at £69.95 plus £9 postage and packing, (UK price £78.95.) | 
Overseas price will be the same as VAT will be offset against extra postage. | 
A Cheques made payable to Arcwind Ltd. | 
i Credit Card Price £73.30 or £15.75 extra with the JS ROMs ry 
E 
ig Access/Visa Number iE 
i Expiry date i 
a | 
a Name - 
§ Address | 
q | 
: Post code - 
i Telephone Number | 
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NEW THIS MONTH 


PRINTMASTER, SOLITAIRE, EASYPTR, 
DISA, REMIND-ME PLUS, DBEASY, 
DBPROGS - SEE SOFTWARE LISTS ON 
THESE TWO PAGES. 


CATALOGUE 


PLEASE ASK FOR A COPY OF OUR QL SOFTWARE 
CATALOGUE. WE NOW SELL SO MANY ITEMS 
THAT WE CANNOT PROVIDE MUCH DETAIL IN 

THE ADVERT, THE CATALOGUE CONTAINS MORE 
DETAILS OF THE PROGRAMS AND A SAMPLE 

SCREEN PRINTOUT FROM MOST OF THEM 


WE WILL BE EXHIBITING AT QUANTA 
WORKSHOPS IN LONDON (30TH MAY) AND 
NEWCASTLE-UPON-TYNE (28TH JUNE) 
AND WOULD LOVE TO SEE YOU THERE! 


SOFTWARE DISCOUNTS 
BUY 2 PROGRAMS TOGETHER 
CLAIM 5% OFF 


BUY 3 OR MORE PROGRAMS 
CLAIM 10% OFF 


LABELS 
MICRODRIVE LABELS ‘roll of 100 £2.00 
DISK LABELS roll of 100 .. £2.00 
100 DISK LABELS on printer ro 
100 ADDRESS LABELS on printer roll : 
Please add £0.50 postage per roll of labels (max 
postage £2.50) if only ordering labels. 


FLOPPY DISKS 

3.5'DSDD UNBRANDED DISKS F 

20 OR MORE UNBRANDED DISKS...... £0.40 
3.5" DSDD SONY BRANDED PACK OF 10.. £9.00 
3.5" DSHD HIGH DENSITY DISKS ; 
5.25" DSDD UNBRANDED DISKS £0.45 
MICRODRIVE CARTRIDGES - please phone to ask 
about price and availability before ordering. 
POSTAGE RATES - SEE BELOW. NO NEED TO ADD 
POSTAGE ON MICRODRIVE CARTRIDGES 


DISK STORAGE BOXES 


POSSO BOXES, drawer style, holds 150 or more 
3.5" disks. Stackable disk storage system, in black, 
like a QL 

Plastic case, holds 80 3.5" disks . 

Plastic case, holds 40 3.5" disks 

(both above boxes have clear, lockable lids and a 
small set of disk dividers) 

Small case for 10 3.5" disks 

POSTAGE RATES - SEE BELOW 


STANDS 
MONITOR STAND, TILT/SWIVELACTIONS, HOLDS MONITORS 
WITH UP TO 14" SCREENS 
PRINTER STAND, 80 COLUMN PRINTERS 
POSTAGE RATES - SEE BELOW 


Dilwyn Jones Computing 


41 Bro Emrys, Tal-y-Bont, 
Bangor, Gwynedd LL57 3YT U.K. 
Tel: Bangor (0248) 354023 


QL SOFTWARE 


NB MEANING OF CODES IN SQUARE BRACKETS BELOW 
[R] RAMDISK REQUIRED 
F AVAILABLE ON FLOPPY DISK 
[1M/2M] AVAILABLE ON MICRODRIVE & NUMBER 

OF CARTRIDGES REQUIRED 
[128/512K] MINIMUM MEMORY REQUIRED 
PRICES OF SOFTWARE AVAILABLE ON MICRODAVIE 
HAVE NOW BEEN SIMPLIFIED. PLEASE ADD £2.00 TO 
THE PRICE SHOWN BELOW TO COVER THE EXTRA 
COST OF THE MICRODRIVE CARTRIDGE(S) AND 
DUPLICATION, OR ENCLOSE YOUR OWN 
CARTRIDGE(S) WITH THE ORDER AND PAY THE 
PRICE SHOWN. 


FILE TRANSFER 


vice versa. No cables required! 
MULTI-DISCOVER 

[F 256K] Enhanced version, also featuring trans- 
fer between QDOS and BBC micro DFS/ADFS, 
CPM and UNIX CP10 disk formats. 


files etc and assist Discover with text file conver- 
sion to other computers. 


LEISURE 
SOLITAIRE 


[F 2M 128K] NEW! A very addictive Patience card 
game, sometimes also known as Klondike, for one 
person. Las Vegas rules option! Great fun and very 
addictive - not a lot of work was done when this one 
arrived! 

CRICKET SECRETARY i 

[F 2M 128K] Record, display and print CRICKET 
AVERAGES, etc - all the traditional features of batting 
and bowling averages, "how out" analysis, best 
bowling, runs per over and bowls per wicket. Useful 
for cricket club secretaries and fun for all cricket buffs 
who'd like to keep a record of how their heroes have 
fared! 


QUESTION MASTER 

[F 2M 128K] Question and multiple choice answers a 
program - use for revision or just for entertainment. 
QUESTION SET 1: GENERAL KNOWLEDGE... £5.00 
QUESTION SET 2: CLASSICAL MUSIC £5.00 
QUESTION SET 3: QL-ESTIONS : 
ALL 3 SETS WORK IN 128K OR MORE MEMORY 
WITH QUESTION MASTER PROGRAM) 


FLEET TACTICAL COMMAND II £49.95 
F512K] Naval strategy game, playable on one or two 
networked computers. Ask about the information 
booklet for this superb game. 


FTC DATA PRINT UTILITY 
F 512K] Add-on for FTC II described above. 


THE FUGITIVE 
F 512K] Text adventure game. 


COCKTAILS WAITER 

F 256K] Database of hundreds of recipes for alco- 
holic drinks. Useful for hotels and bars, or just for 
entertainment at home. 

View, search, select, print, etc. recipes. 

MIX 2 RECIPES FOR C.W..... 

MIX 3 RECIPES FOR C.W...... ‘ 
(BOTH WORK IN 256K OR MORE MEMORY WITH 
THE COCKTAILS WAITER PROGRAM, 100'S OF 
RECIPES) 


PROGRAMMING 


EASYPTR II 

[F 256K] NEW! Albin Hessler's development system 
for pointer environment programming. Assists 
greatly with writing menu's, etc. 

EASYPTR BUDGET VERSION 

DISA DISASSEMBLER 

[F 256K] NEW! Interactive machine code 
disassembler program, runs in pointer environment, 
reviewed in QL World April 1992. 

BASIC REPORTER 

[F 1M 128K] List variable names, keywords, proce- 
dures, etc. Useful for BASIC programmers. 


BUDGET QLIBERATOR COMPILER £25.00 
[F 1M 128K] Version of the QLiberator SuperBASIC 
compiler for unexpanded QL's. 


QLIBERATOR BASIC COMPILER £50.00 
[F 256K] A full QL SuperBASIC compiler with even 
more features than budget version! 


QLOAD & QREF UTILITIES 

[F 1M 128K] QLOAD is a fast load utility for BASIC 
programs. QREF is a cross referencer for listing 
names used in BASIC programs. 


FILE HANDLING 


FILES 2 H 
[F1M 128K] Simple to use popup file handling utility 
for viewing, copying, deleting, renaming etc files. 


FILEMASTER 

(F 1M R 512k] For bulk copying, deleting, etc of files 
quickly via ramdisk, also does simple disk labelling 
& files list printout. : 


THE GOPHER ; 

[F 1M 128K] Searches for and tells you which files 
contain a given text string, e.g. ask it to find letters 
referring to Mr Jones 


WINBACK 

[F 256K] Hard disk backup program for Miracle hard 
disk and compatibles. Version 2 now available (able 
to split large files onto several disks, etc.) - return 
version 1 master disk with £3.00 for upgrade. 


DISPLAY SOFTWARE 


VISION MIXER 1 

{F 2M 384K[ Screen display software, use for an 
eye-catching display of QL mode 4 or mode 8 screens 
e.g. for advertising. New version 1.5 now available 
with builtin speed control. Return master master dis’ 
with £3.00 for upgrade. 


VISION MIXER PLUS 

[F 384K] Enhanced version, but even easier to use| 
Now menu driven, with new effects and greate 
capabilities. 

PICTUREMASTER 

[F 256K] Screen maker for use with Vision Mixers, o 
can also be used as a simple to operate graphicg 
program. 


PICTUREMASTER PLUS 
[F 384K] Enhanced version, with additional features 


UPGRADE TO PICTUREMASTER PLUS .....£5.00 


GRAPHICS 


THE PAINTER V4.04 i 

[F 512K] 100% machine code art and graphics pro- 
gram, by PROGS of Belgium. Multiple screens, can be 
mouse controlled, selection of fonts, patterns, many 
facilities. 


THE CLIPART 
[F 128K] 3 disks full of clipart pictures, for use with 
most DTP/graphics programs. 


QRACTAL i 
[F 512K] Machine code fractals program. Displays 
Julia or Mandelbrot sets. 


QRACTAL SCREENS 
[F 128K] A disk full of sample screen pictures gener- 
ated with the QRactal program. Buy this to see the 
sample pictures, then ask about a discount when 
buying QRactal itself! 


IMAGE PROCESSOR V2 i 

[F 256K] Image enhancement, edge detection, zoom 
and edit, touch up picture generated by digitisers, 
scanners or other graphics programs. Works with 
mode 4 or 8 screens. 

UPGRADE OLD IMAGE PROCESSOR £10.00 
(Send proof of purchase of old version) 


PD2 CLIPART 

[F 128K] Clipart made for PD2 Plus, but available i in 
screen format for use with other DTP/graphics pro- 
grams if required. 


SCREEN SNATCHER ; 
[FIM 128K] ‘Grab’ screen displays from within other 
programs that are not able to save their own displays. 


TEXT ‘N’ GRAPHIX 

[F 256K] NEW! Allows you to insert screens, or part 
of QL screen pictures, into a Quill or plain text file 
printout. Mix NLQ text and graphics in the same 
printout! Currently only for use with 9 pin Epson 
compatible dot matrix printers - ask about a version 
for 24 pin printers due soon. 


TRANS24 
[F IM 128K] T: 
data for a 24 pin printer. 


graphics printouts into 


BIBLE TEXT DISKS, EDITOR FORMAT 

BIBLE TEXT DISKS, QUILL "_DOC" 

F 256K] Text of the King James Bible on Disk. 
Please state whether you require Editor (plain text) 
or Quill "_doc" format. 


SPELLBOUND 
F 1M 384K) A spelling checker which can check 
spelling as you type! 30,000 word dictionary 


SPELLBOUND SPECIAL EDITION £50.00 
F 512K) Enganced version of Spellbound with 
50,000 word dictionary & many new features. 
UPGRADE TO SPELLBOUND S.E............ £30.00 


QUICK POSTERS ; 
(F 2M 128K) Text poster maker, for use with Star 
NL, XB and LC printers. 


Dilwyn Jones Computing 


41 Bro Emrys, Tal-y-Bont, 
Bangor, Gwynedd LL57 3YT U.K. 
Tel: Bangor (0248) 354023 


DATA BASES 


ADDRESS BOOK & LABEL PRINTER £15.00 
[F 2M R 384K] Store names and addresses and 
print them out on a variety of label sizes, or print a 
telephone list, etc. 


database by PROGS of Belgium. Programmable via 
BASIC and machine code interfaces - write your 
own database applications in BASIC using the 
DATA Design commands to help you! Runs in 
pointer environment (supplied) 


FLASHBACK : 
[F 1M 256K] Fast machine code database which is 
also very easy to use. 


FLASHBACK SPECIAL EDITION 

[F 2M 512K] Enhanced version of Flashback, new 
commands, report generator, etc 

UPGRADE TO FLASHBACK S.E................... £20.00 
(return Flashback master disk) 


QL GENEALOGIST, STANDARD VERSION... £19.50 
[F 2M 384K] Family trees and family history 
database, one of our best selling programs. 


QL GENEALOGIST SECOND EDITION £30.00 
[F 384K] Enhanced version - for details see our 
advert in QL World December 1991. 

UPGRADE TO SECOND EDITION 

(return Genealogist master disk) 


BUDGET 128K OL GENEALOGIST £12.00 
[F IM 128K] Cut down version for unexpanded 
machines. 


SUPER DISK INDEXER... 
[F IM 384k] Catalogue you 
database of files. Store it, print it, search & find 
files, make your life easier. 


DBEASY ; 
[F 512K] NEW! A database front end for Archive, 
plus a suite of programs called Chaos Busters. 
Software from EMSoft, U.S.A. 


DBPROGS ; 
[F 512K] NEW! A collection of Archive utilities and 
text files to help you learn to program Archive. 
Software from EMSoft, U.S.A. 


DTP 


PAGE DESIGNER 2 PLUS 

[F 512K] QL Desktop Publishing program, mix text 
and graphics, make printed pages or posters, use 
Clipart, use graphics from other programs etc. 
Prints on most printers. Ask for details! (please 
note: this program has been delayed, apologies to 
those waiting— please check if available before 
ordering) 


QL HARDWARE 


MINI PROCESS CONTROLLER 
Relay switched outputs, controlled via QQL serial 
port. 


SOFTWARE TOOLKIT FOR MPC ABOVE £9.95 
[F 128K] Control the MPC from BASIC programs 
more easily with these extensions. 


NETWORK PROVER 
Plugs between network lead and computer to give 
a visual indication of transmission. 


POSTAGE RATES - SEE BELOW 


OTHER QL SOFTWARE 


PRINTERMASTER ! 
[F IM 128K] NEW! Tame your printer! Popup utility 
with menu selection of control codes to send toa 
printer, Want to change fonts, set paper length, 
margins, set up for listings or wordprocessing etc. 
without having to refer to the manual and struggle 
with control codes. Let Printermaster take the 
strain out of living with your printer. 


HOME BUDGET 
[F IM 128K] Domestic bills and accounts program, 
plus a UK Income Tax Calculator. 


remember about birthdays, licence renewals, etc. 
Quick and very easy to use. 


REMIND-ME PLUS 

(FIM 128k) NEW! Enhanced version with ability: to 
schedule twice as many dates, longer event 
descriptions, etc. 

UPGRADE REMIND-ME TO REMIND-ME PLUS ...£10.00 
Return master disk with order for upgrade 


SCREEN ECONOMISER é 
[F IM 128K] Turns off the QL display after a set 
number of minutes to protect the screen. 


SLOWGOLD 

F 128K] Slowdown routine and control panel for 
software which runs too fast on Gold Card or 
indeed any QL system. 


TASKMASTER 

F IM 384K] Task switching utility. Enables you to 
conveniently switch between several programs in 
memory. Calculator, notepad and file handling 
utility included. 


SUPER DISK LABELLER : 
F 256K] Print neat labels for your floppy disks 
listing the filenames on the disk in columns in 
small print. 


THE CAT 

F IM 128K] List files on a disk or cartridge to the 
screen, or print on paper, in columns (optionally 
sorted in this latest version). Useful and convenient 
utility. 


%& SEE ALSO THE OTHER HALF OF THIS ADVERT ON THE PRECEDING PAGE *& 


SOFTWARE POSTAGE: Software sent post-free to UK addresses. Abroad add £1.00 per program for postage and packing 
SUPPLIES POSTAGE: For disks, boxes and stands, add £2.50 for postage to UK addresses, or 10% of order value (minimum postage £3.50) 


PAYMENT:We can accept payment by cash, cheque (in UK Pounds Sterling only, drawn on UK branch of bank or building society), Postal Order, International 


Postal/Money order, or Eurocheque. We can also accept payment by these credit cards: VISA, ACCESS, MASTERCARD, EUROCARD and also Barclays 
CONNECT card. Please state your card type, number, expiry date and your address (goods paid for by credit card can only be sent to cardholder's address). 
Remember to sign your order. Goods remain property of DJC until paid for in full. Our telephone number above has an answering machine for when we are F 


unable to answer in person — don't be shy! 


for airmail postage where possible 


